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1 Das Small-C-Entwicklungssystem 


Das Small-C-Entwiıcklungssystem ıst eın komplettes Entwicklungspaket für 
das Betriebssystem CP/M mit Editor, C-Compiler, Assembler, Linker und 
vielen weiteren Utilities. Alle Programme sınd ın Small-C geschrieben und 
der Quellcode wird mitgeliefert! Dem kundigen Benutzer wird so die Mög- 
lichkeit gegeben, sıch das Entwicklungssystem nach seinen Wünschen und 
Erfordernissen zu erweitern und zu modifizieren. Darüber hinaus erhält der 
Anwender damit eine umfangreiche Sammlung praxisnaher Programme und 
Tools, die exzellente Beispiele für die effiziente Programmierung in C dar- 
stellen. Dadurch ist dieses Produkt eine wertvolle Fundgrube für jeden 
ernsthaften C-Programmierer. 


Das Paket besteht aus drei Teilen, die wiederum aus mehreren Komponen- 
ten bestehen: 


Small-C-Compiler 


Small-C ist ein umfangreicher Subset der Sprache C, dessen Qualität durch 
diese Programme selbst, die alle ın dieser Sprache geschrieben wurden, 
dokumentiert wird. Der Compiler übersetzt C-Programme ın 8080-Assem- 
bler; zur Übersetzung des Assembler-Codes kann der mitgelieferte Makro- 
Assembler oder auch der Microsoft-Assembler M80 verwendet werden. 


Small-Mac: 8080-/Z80-Makroassembler und Utilities 


Der Makroassembler-Teil besteht aus sechs Programmen. MAC ıst der 
eigentliche Makroassembler. Er arbeitet mit zwei Läufen und erzeugt relo- 
katierbaren 8-Bit-Objektcode im Microsoft-Format. MAC kann mit Hilfe 
des Programms CMIT an den Befehlssatz der Prozessoren 8080 oder Z80 
angepaßt werden. Der Linker LNK verknüpft Objektmodule mit den benö- 
tigten Bibliotheksmodulen zu ausführbaren Programmen. Mit dem Loader 
LGO können Betriebssystemerweiterungen geladen und gestartet werden. 
Der Bibliotheksmanager LIB verwaltet Bibliotheken mit LNK-kompatiblen 
Objektmodulen und DREL erlaubt den Dump von LNK- und LIB-Dateien. 


Small-Tools: Editor und Text-Tools 


Small-Tools ist eine komfortable Sammlung von Text-Tools, die einen 
weiten Bereich der Textverarbeitung abdecken, von der Eingabe von Pro- 
grammen und Texten (EDIT) über dıe Erstellung von Serienbriefen und 
Formatierung von beliebigen Manuskripten (FORMAT) bis zur Recht- 
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schreibüberprüfung (englisch) und Sortierung von ASCII-Dateien (SORT/ 
MERGE). Darüber hınaus stehen noch etliche Hilfsprogramme zur Verfü- 
gung, die kleinere Aufgaben erledigen, jedoch kombiniert eingesetzt wer- 
den können und so zu einem extrem leistungsfähigen Tool werden. 


Hardwarevoraussetzungen 


Das Small-C-Entwicklungssystem benötigt einen Computer mit dem Be- 
triebssystem CP/M-80, einem Diskettenlaufwerk und mindestens 56 KByte 
Speicher. 


Disketteninhalte 


Das Small-C-Entwicklungspaket wird in verschiedenen Diskettenformaten 
angeboten. Je nach Diskettenkapazität werden eine bis fünf Disketten 
geliefert. Im folgenden finden Sie eine Übersicht der Inhalte der einzelnen 
Disketten bei der Auslieferung auf fünf Disketten, bzw. Diskettenseiten. 
Bei Lieferung auf weniger Disketten wurden die Dateien in geeigneter 
Weise auf weniger Disketten kopiert. Small-C und Small-Mac werden in 
lauffähiger Version und auch im Quellcode ausgeliefert, die Small-Tools 
aus Platzgründen jedoch nur im Quellcode. 


Wichtig! Bevor Sıe mit dem Small-C-Entwicklungspaket arbeiten, fertigen 
Sie sich bitte unbedingt erst Kopien aller Disketten an und lagern Sie die 
Original-Disketten an einem sicheren Ort. Die Erstellung von Kopien ist im 
Bedienungshandbuch Ihres Computers erläutert. Vergewissern Sie sich vorm 
Kopieren, daß der Schreibschutz der Original-Disketten aktiviert ist, damit 
Sie diese nicht versehentlich überschreiben. Arbeiten Sie bitte nur mit den 
Kopien, damit Sie bei Beschädigungen Ihrer Arbeitsdisketten immer die 
Möglichkeit haben, auf die Original-Disketten zurückzugreifen. 


Jede Datei des Small-C-Pakets wird in den Aufstellungen auf‘ den folgen- 
den Seiten kurz erläutert. 
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Verzeichnis von Small-C 1 (11 Dateien): 


CLIB 
HISTORY 
NEWLIB1 
NEWLIB2 
NEWLIB3 
STDIO 


C 

COM 
COM 
SUB 
SUB 
REL 


SUB 
SUB 
SUB 
H 


Programm zum Verwalten von Archivdateien, Quellcode 

Programm zum Verwalten von Archivdateien 

Small -C-Compiler 

Submit-Datei zum Kompilieren von C-Programmen mit M80 und L8O 
Submit-Datei zum Kompilieren des Small-C-Compilers mit M80 und L80 
C-Bibliothek im relokatierbaren Microsoft-Format 
Wartungsgeschichte von Small-C 

Submit-Datei zum Erstellen einer neuen Bibliothek, Teil 1 
Submit-Datei zum Erstellen einer neuen Bibliothek, Teil 2 
Submit-Datei zum Erstellen einer neuen Bibliothek, Teil 3 
Standard-Definitionsdatei von Small-C 


Verzeichnis von Small-C 2 (2 Dateien): 


CC 
CLIB 


ARC 
ARC 


Archivdatei mit dem Quellcode des Small-C-Compilers 
Archivdatei mit dem Quellcode der Small-C-Bibliothek 
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Verzeichnis von Small-Mac | (10 Dateien): 


C 
C 
C 
CMIT 
DREL 


HISTORY 


LGO 
LIB 
LNK 
MAC 


LIB 
LST 
NDX 
COM 
COM 


COM 
COM 
COM 
COM 


Small-C-Bibliothek im Small -Mac-Format 
Small-C-Bibliothek, Modulverzeichnis 
Small-C-Bibliothek, Indexdatei 
Anpassungsutility für Small-Mac 

Dump relokatierbarer Objektdateien 
Wartungsgeschichte von Small -Mac 

Lader von Small -Mac 
Bibliotheksverwalter von Small-Mac 
Linker von Small -Mac 

Small -Mac-Makroassembler 


Verzeichnis von Small-Mac 2 (34 Dateien): 


8080 
CALL 
- CMIT 
DREL 


"MAC2 

«MAC3 
MESS 
MIT 
MIT 
NOTICE 
PUTREL 
REL 
REL 
REQ 
SCAN 
SEEREL 
STDIO 
WAIT 
Z80 


MIT 
MAC 
C 


zn 
> 
N 


x-4n mM 


Ti 
— 


Maschinen-Instruktions-Tabelle für 8080 
Logische und arithmetische Funktionen von Small-C 
Anpassungsutility, Quellcode 

Dump relokatierbarer Objektmodule, Quellcode 
Endemodul von Small-C | 
Include-Datei für Small -Mac 
Bibliotheksmodul für M.LIB 
Bibljotheksmodul für M.LIB 
Bibliotheksmodul für M.LIB 
Bibliotheksmodul für M.LIB 

Lader, Quellcode 

Bibliotheksverwalter, Quellcode 
Small-C-Modul zur Verknüpfung mit der Bibliothek 
Linker, Quellcode 

Small-Mac-Bibliothek 

Small-Mac-Bibliothek, Modulverzeichnis 
Small-Mac-Bibliothek, Indexdatei 
Definitionsdatei für Small -Mac 
Small-Mac-Makroassembler, Quellcode Teil 1 
Small-Mac-Makroassembler, Quellcode Teil 2 
Small -Mac-Makroassembler, Quellcode Teil 3 
Bibliotheksmodul für M.LIB 
Bibliotheksmodul für M.LIB 

Include-Datei für Small-Mac 

Include-Datei für Small-Mac 
Bibliotheksmodul für M.LIB 
Bibliotheksmodul für M.LIB 

Include-Datei für Small -Mac 
Bibliotheksmodul für M.LIB 
Bibliotheksmodul für M.LIB 
Bibliotheksmodul für M.LIB 
Standard-Definitionsdatei von Small-C 
Bibliotheksmodul für M.LIB 
Maschinen-Instruktions-Tabelle für Z80 
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Verzeichnis von Small-Tools (44 Dateien): 


„ BUF 


1] 


- CANT 


CATSUB 


- CHG 


CNT 


- CPT 


CPY 
DICT 


. DIGIT 





- DTB 
" EDT 


EDT2 
ERROR 
ETB 

FMT 
FMT2 
FMT3 
FND 

FNT 
GETWRD 
HISTORY 


: INDEX 


LST 


. MAKSET 


MAKSUB 
MRG 
OUT 
PAGE 


. PAT 


PRINTF 
PROOF 
PRT 
SAME 
SCOPY 
SETTAB 
SRT 
STDIO 
STP 
STRIP 
TABPOS 
TOOLS 
TRIM 
TRN 
XINDEX 


ONOZNINONIZENNNNNNNNNNININNN nDnnnnnnNN2N9IX9X9X9 NN 


Include-Datei für Small-Tools 
Include-Datei für Small-Tools 
Include-Datei für Small -Tools 
Small -Tools-Programm CHANGE 
Small-Tools-Programm COUNT 
Small-Tools-Programm CRYPT 

Small -Tools-Programm COPY 
englisches Wörterverzeichnis für PROOF.SUB 
Include-Datei für Small-Tools 
Small -Tools-Programm DETAB 

Small -Tools-EDITor Teil 1 
Small-Tools-EDITor Teil 2 
Include-Datei für Small-Tools 
Small -Tools Programm 

Small -Tools-TextFORMATierer Teil 1 
Small-Tools-TextFORMATierer Teil 2 
Small -Tools-TextFORMATierer Teil 3 
Small -Tools-Programm FIND 

Small -Tools-Programm FONT 
Include-Datei für Small-Tools 
Wartungsgeschichte von Small -Tools 
Include-Dateı für Small-Tools 
Small-Tools-Programm LIST 
Include-Datei für Small-Tools 
Include-Datei für Small-Tools 
Small -Tools-Programm MERGE 
Include-Datei für Small-Tools 
Include-Datei für Small-Tools 
Include-Datei für Small-Tools 
Include-Datei für Small-Tools 


Submit-Datei für die Rechtschreibprüfung enlischer Texte 


Small -Tools-Programm PRINT 
Include-Datei für Small-Tools 
Include-Datei für Small-Tools 
Include-Datei für Small-Tools 

Small -Tools-Programm SORT 
Standard-Definitionsdatei von Small-C 
Small -Tools-Programm SETUP 
Include-Datei für Small-Tools 
Include-Datei für Small-Tools 
Standard-Definitionsdatei von Small-C 
Include-Datei für Small-Tools 
Small-Tools-Programm TRANS 
Include-Datei für Small-Tools 
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2 Der Small-C-Compiler 


Der Small-C-Compiler übersetzt eine Untermenge der Sprache C ın 8080- 
Assemblercode, der mit einem Assembler übersetzt werden muß. Er läuft 
auf Systemen mit 8080, Z80 oder dazu kompatiblen Mikroprozessoren unter 
dem Betriebssystem CP/M-80 Version 2.2 oder später. Der erzeugte Assem- 
blercode ist kompatibel zum Small-Mac-Makroassembler (der Bestandteil 
des Small-C-Entwicklungspaketes ist) und zum Microsoft-Assembler M80. 
Der Small-C-Compiler unterstützt alle Möglichkeiten dieser Assembler und 
des Small-C-Entwicklungspaketes wie zum Beispiel relokatierbaren Objekt- 
code, das Linken separat kompilierter Module und Verwaltung der reloka- 
tierbaren Objektmodule ın Bibliotheken. 


Der Small-C-Compiler ist selbst ın Small-C geschrieben und wird mit 
Quellcode geliefert. Dadurch kann der Small-C-Compiler modifiziert oder 
an andere Umgebungen angepaßt werden. 


Aufruf des Compilers 


Beim Aufruf des Compilers können drei Arten von Parametern angegeben 
werden, Dateinamen, Umlenkungsanweisungen und Schalter. Das Laufzeit- 
system bewerkstelligt die Umlenkung, ohne sıe an das Programm weiter- 
zugeben. 


Der Small-C-Compiler erhält seine Eingabe standardmäßig von der Stan- 
dardeingabe (stdin). Die Standardeingabe kann mit der Umlenkungsanwei- 
sung < auf eine Datei oder ein Gerät umgelenkt werden. Wenn ein oder 
mehrere Dateinamen ın der Befehlszeile vorhanden sind, nımmt der Small- 
C-Compiler seine Eingabe nicht von stdin, sondern ın der angegeben Rei- 
henfolge aus den Dateien. Die Standarderweiterung beı Eingabedateien ist 
C. Jeder Parameter, der kein Schalter ist (zum Beispiel ein einzelner Binde- 
strich), wird als Dateiname interpretiert. 


Wenn die Eingabe nicht über stdin erfolgt, geht die Ausgabe des generier- 
ten Assemblercodes in eine Datei mit dem Namen der ersten angegebenen 
Quelldateı und der Namenserweiterung MAC. Wenn keine Dateinamen an- 
gegeben werden, erfolgen Ein- und Ausgabe über die Standardein-/aus- 
gabedateien. Umlenkung (<,>) kann benutzt werden, um die voreingestell- 
ten Zuweisungen zu ändern. 
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Die Schalter bestehen aus einem Bindestrich gefolgt von einem Buchstaben 
und eventuell weiteren Angaben. Durch einen Bindestrich ohne Buchstaben 
("-") oder jeden undefinierten Schalter, bricht der Compiler ab, nachdem 
der folgende Bedienungshinweis angezeigt worden ist: 


usage: cc [file)... [-m) C-al [-p) [-I# L-o) [-b#] 


Der Schalter -M (Monitor) bewirkt, daß der Compiler die Kopfzeilen der 
Funktionen auf dem Bildschirm anzeigt, so daß man jederzeit weiß, wie 
weit die Kompilierung fortgeschritten ist. Der Schalter ist nützlich, um 
Fehler innerhalb der Funktionen zu identifizieren. 


Der Schalter -A (Alarm) bewirkt, daß beı Fehlern ein Piepser ertönt. 


Der Schalter -P (Pause) bewirkt, daß der Compiler nach jedem Fehler an- 
hält. Durch Drücken von RETURN wird die Verarbeitung wieder aufge- 
nommen. 


Der Schalter -L# (Listing, # ist ein Dateideskriptor im Bereich 1-9) weist 
Small-C an, den Quellcode der angegeben Dateı zu listen. Wenn als Datei- 
beschreibung 1 (stdout) angegeben ist, wird das Listing mit der normalen 
Ausgabe gemischt. In diesem Fall geht jeder Quellzeile ein Semikolon vor- 
aus. Es gibt kein Listing, wenn der Schalter nicht angegeben ist. 


Der Schalter -O (Optimierung) bewirkt, daß der Optimierer des Small-C- 
Compilers die Programmgröße auf Kosten der Geschwindigkeit reduziert. 


Der Ausgabe wird automatisch Anfangs- und Endecode hinzugefügt, damit 
Programme aus mehreren Dateien getrennt kompiliert und assembliert wer- 
den können. Der Schalter -B# existiert nur, wenn der Compiler nicht für 
die Kombination mit einem Linker konfiguriert ist. In diesem Fall werden 
Programmteile beim Assemblieren und nicht erst beim Linken kombiniert 
und es ıst notwendig, daß die verwendeten Label nicht doppelt vor- 
kommen. Die Labelnumerierung beginnt mit dem Wert #. Wenn # 0 ist (die 
Standardeinstellung), wird ein komplettes Programm kompiliert. In diesem 
Fall wird dem Programm Kopf- und Endecode für die Verbindung mit der 
Bibliothek bzw. dem Laufzeitsystem hinzugefügt. Ein Wert von 1 bedeutet, 
daß der erste Teıl eines mehrteiligen Programms kompiliert wird; nur der 
Startcode wird hinzugefügt. Ein Wert zwischen 1 und 9000 definiert einen 
Zwischenteil; in diesem Fall wird kein Code zur Ausgabe hinzugefügt. Ein 
Wert von 9000 bedeutet, daß der letzte Teil kompiliert wird; Endecode 
wird hinzugefügt. Die Werte für # müssen so gewählt werden, daß Kon- 
flikte mit Labeln aus anderen Programmteilen vermieden werden. 
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Beispiele 
AUFRUF KOMMENTAR 


Ce 
Kompiliert die Tastatureingaben und gibt den erzeugten 
Code auf dem Bildschirm aus. 

CC test 
Kompiliert test.c in eine Ausgabedateiı mit dem Namen 
test.mac. 

CC abc def -o -a 
Kompiliert erst abc.c, dann def.c ın eine Ausgabedateı mit 
dem Namen abc.mac. Es wird auf Codegröße hın optimiert 
und es ertönt ein Piepser, wenn ein Fehler auftritt. 

CC <prog.c -11 -p 
Kompiliert prog.c und gibt den erzeugten Code auf dem 
Bildschirm aus. Die Quelldateı wird als Kommentar mit in 
die Ausgabe aufgenommen. 

CC <abc.c >xyz.mac -m 
Kompiliert abc.c und erzeugt xyz.mac. Die jeweils erste 
Zeile einer Funktion wird auf dem Bildschirm ausgegeben. 


Fehlermeldungen 


Der Compiler unterdrückt ın einer einfachen Anweisung alle Fehlermel- 
dungen bis auf die erste; ın der Praxis funktioniert das gut, da eine Mel- 
dung genug ist, um den Fehler ın einer Anweisung oder einem Ausdruck 
zu erkennen. 


Wenn der Compiler auf eınen Fehler stößt, wird auf dem Bildschirm die 
fehlerhafte Zeile angezeigt. Ein Pfeil aus den Zeichen /\ wird unter der 
Zeile ausgegeben und markiert die ungefähre Stelle des Fehlers. Wenn es 
durch den Schalter -p angefordert wurde, hält der Compiler dann an und 
wartet auf die Betätigung der Return-Taste. 


Einige Programme bewirken, daß eine der internen Tabellen des Compilers 
überläuft. Wenn dies passiert gibt es zwei Möglichkeiten zu reagieren: 


l.e Neukompilierung des Compilers, wobeı dem zu kleinen Puffer mehr 
Speicher zugewiesen wird. . 

2. Anderung des Programms, so daß die Uberlaufbedingung beseitigt 
wird. | 


Es folgt unten eine alphabetische Liste der Fehlermeldungen mit einer kur- 
zen Erläuterung. Die Erläuterungen beschreiben die Fehlerursachen und 
Korrekturmöglichkeiten. Gelegentlich kann jedoch eine Fehlermeldung 
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unter Umständen auftreten, die nicht vom Compiler vorausgesehen werden 
konnten. Die Fehlermeldungen passen also nicht in allen Fällen exakt zu 
den wirklichen Fehlern. 


MELDUNG ERLÄUTERUNG 


already defined 
Ein Name wurde auf globaler Ebene oder unter den forma- 
len Argumenten mehr als einmal deklariıert. 

bad label 
Eine goto-Anweisung ist mit einem ungültigen Label verse- 
hen. Entweder stimmt es nicht mit den C-Namensregel 
überein oder es fehlt ganz. 

can't subscript 
Ein Index wird mit etwas verwendet, das weder eın Zeiger 
noch eın Array ist. 

cannot assign to pointer 

| Eine Initialisierung bestehend aus einer Konstanten oder 

einem konstanten Ausdruck wird mit einem Zeiger ın Ver- 
bindung gebracht. Bei Integer-Zeigern (int) ist keine Iniıtiali- 
sierungsanweisung erlaubt und beı Zeichen-Zeigern (char) 
ist nur eine Ausdrucksliste oder eine Stringkonstante erlaubt. 

global symbol table overflow 
Die Tabelle für globale Symbole ıst übergelaufen. Dies kann 
behoben werden, ındem der Compiler mit höheren Werten 
für die Symbole NUMGLBS und SYMTBSZ (definiert in 
CC.DEF) kompiliert wird. NUMGLBS ist dıe Anzahl der 
globalen Einträge, die ın die Tabelle passen, SYMTBSZ ist 
die kombinierte Größe (in Bytes) der lokalen und der glo- 
balen Tabellen. Ein Kommentar im Quelltext erläutert die 
Berechnung von SYMTBSZ. 

illegal adress 
Der Adreß-Operator wurde auf etwas angewendet, was we- 
der eine Variable, ein Zeiger (mit oder ohne Index) noch ein 
indizierter Arrayname ist. 

illegal argument name 
Ein Name in der Argumentliste einer Funktiondeklaration 
entspricht nicht den Regeln zur Bildung eines C-Namens. 

illegal symbol 
Der Compiler hat ein Symbol gefunden, das nicht den Re- 
geln zur Bildung eines C-Namens entspricht. 

invalid expression 
Ein Ausdruck besteht aus Teilen, die weder eine Konstante, 
eine Stringkonstante noch ein gültiger C-Name sind. 
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line too long 
Eine Quellzeile ıst nach der Bearbeitung durch den Präpro- 
zessor länger als LINEMAX (80) Zeichen. Dies kann da- 
durch behoben werden, daß die Zeile aufgeteilt wird. Es 
kann jedoch auch der Compiler mit einem größeren Wert 
für LINEMAX (in CC.DEF) neu kompiliert werden. Es ist 
zu beachten, daß LINESIZE um 1 größer sein muß als 
LINEMAX. 

literal queue overflow 
Eine Stringkonstante führt zum Überlauf der Literaltabelle 
des Compilers. Die Literaltabelle wırd dazu verwendet, um 
Stringkonstanten bis zum Ende einer Funktion zu speichern, 
erst dann werden sıe ausgegeben und wieder gelöscht. Die 
Literaltabelle kann durch Neukompilierung des Compilers 
vergrößert werden. Es muß dazu eın größerer Wert für 
LITABSZ (in CC.DEF) angegeben werden. LITABSZ ist die 
Größe der Literaltabelle in Bytes. Jede Stringkonstante wird 
ın diesem Puffer mit einem Nullbyte abgeschlossen. 

local symbol table overflow 
Eine lokale Deklaration führt zum Überlauf der Symbol- 
tabelle. Die lokale Symboltabelle ist eine Tabelle, in der die 
Argumente, die einer Funktion übergeben werden, und die 
lokalen Variablen innerhalb einer Funktion beschrieben 
werden. Sıe wird nach jeder Funktion zur Verwendung 
durch die nächste gelöscht. Sie muß also groß genug für die 
Deklarationen einer Funktion sein. Diese Meldung kann be- 
seitigt werden, indem der Compiler mit größeren Werten für 
NUMLOCS und SYMTBSZ (in CC.DEF) neu kompiliert 
wird. NUMLOCS ıst die Anzahl der Einträge in der Tabelle, 
SYMTBSZ ist die kombinierte Größe der lokalen und der 
globalen Tabellen in Bytes. Ein Kommentar im Quelltext er- 
läutert die Berechnung von SYMTBSZ. 

macro name table full 
Eine #define-Anweisung führt zum Überlauf der Makro- 
namentabelle. Diese Tabelle kann erweitert werden, indem 
der Compiler mit größeren Werten für MACNBR und 
MACNSIZE (definiert in CC.DEF) kompiliert wird. MAC- 
NBR ıst die Anzahl Namen, die in die Tabelle passen und 
MACNSIZE ist die Größe der Makronamentabelle in Bytes. 

macro string queue full 
Eine #define-Anweisung führt zum Überlauf der Makro- 
stringtabelle. Die Makrostringtabelle ıst ein Puffer, in dem 
die Ersatzstrings von Makronamen gespeichert werden. Die- 
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ser Fehler kann beseitigt werden, ındem der Compiler mit 
einem größeren Wert für MACQSIZE (in CC.DEF) kompi- 
liert wird. MACQSIZE ist die Größe des Makrostringpuffers 
in Bytes. Er muß alle Ersatzstrings aufnehmen können, die 
innerhalb eines Programmes definiert werden. Jeder String 
wird durch ein Nullbyte abgeschlossen. 
missing token 
Die Syntax erfordert an dieser Stelle eine bestimmte An- 
weisung, die nicht vorhanden ist. 
multiple defaults 
Eine switch- Anweisung enthält mehrere default-Label. 
must assign to char pointer or array 
Es wird versucht, etwas anderes mit einer Stringkonstante zu 
inıtialisieren als ein Zeichen-Zeiger oder Zeichenarray. 
must be constant expression 
Es wurde dort, wo die Syntax einen konstanten Ausdruck 
erforderlich macht, etwas anderes gefunden. 
must be lvalue 
Etwas anderes als ein /value wırd ım Empfangsfeld eines 
Ausdrucks verwendet. Ein /value ıst ein Ausdruck (eventuell 
nur ein Name), der einer Speicherstelle entspricht, die ver- 
ändert werden kann. 
must declare first in Block 
Eıne lokale Deklaration steht ın einem Block nach der ersten 
Anweisung. | 
negative size illegal 
Eine Arraydımenionierung ist negativ. Es ist zu beachten, 
daß auch konstante Ausdrücke als Arraydimensionen ver- 
wendet werden können. 
no apostrophe 
Einer Zeichenkonstante fehlt der abschließende Apostroph. 
no closing bracket 
Es trat das Dateiende mitten in einer Funktion auf. 
no comma 
In einer Argument- oder Deklarationsliste fehlt ein Komma. 
no final ) 
Es trat das Dateiende mitten in einer zusammengesetzten 
Anweisung auf. 
no matching #if 
Einem #else oder #endif ıst kein #ifdef oder #ifndef vor- 
ausgegangen. 
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no open paren 
Bei einer Funktion fehlt die linke Klammer, die die Argu- 
mentliste einleitet. 

no quote 
Einer Stringkonstanten fehlt der abschließende Anführungs- 
strich ("). Stringkonstanten können nicht auf der folgenden 
Zeile fortgesetzt werden, der abschließende Anführungs- 
strich muß also auf derselben Zeile stehen, wie der einlei- 
tende. 

no semicolon 
Es fehlt an einer Stelle ein Semikolon, an der von der Syn- 
tax eines vorgeschrieben ist. 

not a label 
Der Name in der goto-Anweisung ist zwar definiert, jedoch 
nicht als Label. 

not allowed with block-locals 
Eine goto-Anweisung tritt in einer Funktion auf, die lokale 
Deklarationen auf einer niedrigeren Ebene aufweist, als der 
Funktionskopf. Small-C kann so etwas nicht verarbeiten. 

not allowed with goto 
Eine lokale Deklaration tritt auf einer niedrigeren Ebene 
auf, als die Funktion mit einer goto-Anweisung. Small-C 
kann so etwas nıcht verarbeiten. 

not allowed in switch 
Innerhalb einer switch- Anweisung tritt eine lokale Deklara- 
tıon auf. Dies ıst bei Small-C nicht erlaubt. 

not an argument 
Die Elemente einer Argumentliste einer Funktion stimmen 
nicht mit der entsprechenden Typendeklaratıon überein. 

not in switch 
Die reservierten Worte case oder default stehen außerhalb 
einer switch- Anweisung. 

open error on filename 
Eine Eın- oder Ausgabedateı kann nicht geöffnet werden. 

open failure on include file 
Eine Datei, die in einer #include-Anweisung angegeben 
wurde, kann nicht geöffnet werden. 

out of context 
Eine break-Anweisung steht nicht innerhalb einer der An- 
weisungen do, for, while, switch oder ein continue steht 
nicht innerhalb einer der Anweisungen do, for oder while. 
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output error 
Während des Schreibens auf Diskette ist ein Fehler aufgetre- 
ten. Dies kann an einem Ein-/Ausgabefehler, einer schreib- 
geschützen Diskette oder ungenügend Diskettenspeicher 
liegen. 

staging buffer overflow 
Der für einen Ausdruck erzeugte Code übersteigt das 
Fassungsvermögen des Codepuffers. Der Codepuffer nimmt 
zeitweise den von einem Ausdruck erzeugten Code auf, so 
daß er noch im Nachhinein geändert werden kann. Wenn das 
Ende eines Ausdrucks erreicht ist, wırd der Puffer aus- 
gegeben und für den nächsten Ausdruck freigemacht. Dieser 
Fehler kann behoben werden, indem der Ausdruck in meh- 
rere kleine Ausdrücke aufgeteilt wird oder indem der Com- 
pıler mit einem größeren Wert für STAGESIZE (definiert in 
CC.DEF) neu kompiliert wird. STAGESIZE ist die Größe 
des Codepuffers in Bytes. 

too many active loops 
Die Verschachtelungstiefe einer Kombination aus den An- 
weisungen do, for, while und switch übersteigt das Fas- 
sungsvermögen der While-Tabelle. Diese Meldung stimmt im 
Falle von switch nicht ganz, da es sich dabei nicht um eine 
Schleifenanweisung handelt. Dieser Fehler kann behoben 
werden, indem der Wert WQTABSZ (definiert in CC.DEF) 
vergrößert wırd. WQTABSZ ıst die Größe der While-Tabelle 
in Bytes. Sie muß ein Vielfaches von WQSZ sein. 

too many cases 
Die Anzahl der Case-Fälle übersteigt das Fassungsvermögen 
der Switch-Tabelle. Die Switch-Tabelle kann vergrößert 
werden, indem der Wert SWTABSZ (definiert in CC.DEF) 
vergrößert und der Compiler neu kompiliert wırd. SWTAB- 
SZ ıst die Größe der Switch-Tabelle in Bytes. Sie muß ein 
Vielfaches von SWSIZE sein. 

wrong number of arguments 
Es wurde für ein oder mehrere Argumente einer Funktion 
bis zum Beginn der eigentlichen Funktion keine Typen- 
deklaration vorgenommen. 
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Sprachumfang 


Hier soll nicht die komplette Syntax von Small-C erläutert werden, es wer- 
den ım wesentlichen nur die Unterschiede zum vollen C beschrieben. Zum 
Erlernen von C sollten andere Bücher herangezogen werden, zum Beispiel 
das Standardwerk über die Programmiersprache C von Kernighan und 
Ritchie. 


Die vom Small-C-Compiler akzeptierte Syntax ist eine Untermenge der 
Standard-C-Sprache. Innerhalb dieser Untermenge weicht sıe nicht von der 
Standard-Syntax ab, was bedeutet, daß die für Small-C geschriebenen Pro- 
gramme unter Unix kompiliert werden und laufen können. Obgleich die 
Untermenge begrenzt ist und der Compiler daher nicht jedes schon be- 
stehenden C-Programm akzeptiert, sind die Programme, die man damit 
schreiben kann, kompatibel zu den vollständigen Compilern. 


Grob gesagt sınd folgende Eigenschaften des vollen Standard-C nicht ver- 
fügbar: 


Fließkomma-Datentypen, 
mehrdimensionale Arrays, 
Strukturen (struct) und unions, 
Bit-Felder, 

Zeigerarrays, 

sizeof, 

und Casts. 


OO O0O000O00O0 


Das Ziel war nicht die Unterstützung des vollen C, sondern einer genügend 
großen Untermenge, die es erlaubt, leistungsfähige C-Programme zu 
schreiben, die zum Standard-C kompatibel sind. 


Small-C versteht folgende Steueranweisungen: if, switch, case, default, 
goto, break, continue, while, for und do/while. 


Es werden die folgenden Zuweisungsoperatoren unterstützt: |=, "=, &=, +=, 
-=, *=, /=, %=, >>= und <<=. 


Small-C kennt die logischen Operatoren || und &&. Die Auswertung erfolgt 
von links nach rechts und wird beendet, wenn das Ergebnis bekannt ist. 
Die logischen Operatoren - und ! werden unterstützt. 


Der Präprozessor des Small-C-Compilers unterstützt dıe Anweisungen #in- 
clude, #define, #ifdef, #ifndef, #else, #endif, #asm und #endasm. Die 
Anweisungen #ifdef, #ifndef, #else und #endif werden auch geschachtelt 
unterstützt. 
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Es werden nur die beiden Datentypen Integer (int) und Zeichen (char) un- 
terstützt. Dies bedeutet, daß der Compiler nur eine Integer-Untermenge der 
Sprache ist, Fließkommazahlen also nıcht verwendet werden können. 


Erlaubte Modifizierungen der zwei Grundtypen sind: 


l. *name: erklärt name als Zeiger auf ein Element des angegebenen Typs 

2. name []: syntaktisch identisch zur obigen Zeiger-Erklärung 

3. name [Größe]: deklariert ein Array mit der angegebenen Größe, wobei 
jedes Arrayelement vom entsprechenden Typ ist 


Innerhalb eines Programms nicht definierte Funktionen werden automatisch 
als extern deklariert. 


Die Bibliothek 


Small-C unterstützt mit Hilfe seiner Bibliothek und seines Laufzeitsystems 
(siehe folgendes Kapitel) eine Unix-ähnliche Eıin-/Ausgabe-Umleitung und 
Übergabe der Befehlszeilenparameter. Die Standardausgabe kann an beste- 
hende Dateien angehängt werden (>>). Diskettenverzeichnisse können gele- 
sen werden (<B:). Die Bibliothek von Small-C enthält über 80 Funktionen 
und ist damit eine fast vollständige Implementation der Standardbibliothek 
von Unix-Systemen. 


Es wird sowohl ASCII- als auch binäre Ein-/Ausgabe unterstützt. Die 
Funktionen printf und scanf für die formatierte Ein-/Ausgabe sind Be- 
standteile der Bibliothek. Direktzugriffsdateien sind auf der CP/M-Satz- 
ebene möglich. Programme können für bestimmte Dateien einen beliebig 
großen Puffer anfordern. 


Assemblercode in C-Programmen 


Da der Small-C-Compiler Assemblercode erzeugt, können innerhalb von 
Small-C-Programmen auch Assembleranweisungen verwendet werden. Dies 
geschieht mittels der Präprozessoranweisungen #asm und #endasm. Alles 
was zwischen diesen beiden Anweisungen steht, wird direkt in die erzeugte 
Assemblerdatei übernommen. 


Dateninitialisierung 


Man kann globale Variablen, Arrayelemente und Zeiger genau wie im 
vollen C initialisieren, außer das Symbole nicht zur Initialisierung verwen- 
det werden dürfen. Ohne Initialisierung werden globale Variable standard- 
mäßıg auf Null gesetzt. 
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Es können nur konstante Ausdrücke für die Initialisierung von Varıablen 
und Arrayelementen benutzt werden. Wenn die Größe des Arrays nicht ge- 
geben ist, wird sie durch die Zahl der vorhandenen Initialisierungswerte 
bestimmt. Zeichenkonstanten mit Backslash-Escapesequenzen sınd erlaubt. 
Wenn mehrfache Initialisierungsparameter vorhanden sınd, müssen sıe ın 
Klammern eingeschlossen und durch Komma getrennt werden. Wenn zu 
wenig Initialisierungswerte vorhanden sind, werden die übrigbleibenden 
Elemente auf Null gesetzt. Bei zu vielen Werten wird eine Fehlermeldung 
ausgegeben. 


Man kann eine Zeichenkette mit Anführungszeichen verwenden, um Zei- 
chenarrays und Zeiger anzulegen. In diesem Fall wird automatisch ein 
Null-Byte am Ende generiert. Ein Arrayname bezieht sich auf das erste 
Byte und ein Zeiger enthält die Adresse des ersten Bytes. Wenn keine 
Arraygröße angegeben ist, wird sie auf die Länge der Zeichenkette plus | 
gesetzt. Wenn die Zeichenkette länger ist als die angenommene Größe, wird 
die Größe erhöht, damit sie mit der der Zeichenkette übereinstimmen. 


Lokale Deklarationen 


Der ursprüngliche Compiler akzeptierte lokale Deklarationen überall in ei- 
ner Funktion und doppelte Deklarationen verursachten Fehler. Diese Ver- 
sion erfordert, daß alle Deklarationen innerhalb eines Blockes zuerst er- 
scheinen. Erlaubt sind mehrfache Deklarationen desselben Symbols. Der lo- 
kale Teil der Symboltabelle wırd ın umgekehrter Reihenfolge durchsucht, 
um das letzte Vorkommen einer Variablen zuerst zu finden. Beim Verlassen 
eines Blocks werden die Deklarationen ohne Label ınnerhalb dieses Blocks 
aus der Symboltabelle entfernt. Lokale Deklarationen dürfen keine Initialı- 
sierungswerte enthalten. 


Goto-Anweisung 


Es besteht in C-Programmen eigentlich keine zwingende Notwendigkeit für 
goto und man sollte es so weit wie möglich vermeiden, da man dadurch 
sehr leicht die Programmlogik zerstören kann. Gelegentlich gibt es jedoch 
Situationen, bei denen man weitschweifigen Code vermeiden kann, ohne 
die Logik zu verstecken. Es ist ebenfalls nützlich, wenn man existierende 
Programme nach Small-C konvertieren will. Deshalb gehört goto zum 
Sprachumfang von Small-C. 


Es gıbt eine Einschränkung beı der Benutzung der goto-Anweisung. Da 
lokale Variable innerhalb eines beliebigen Blocks deklariert werden können, 
kennt der Compiler die Tiefe des Stapel-Zeigers bei Ziellabeln, die bis 
jetzt noch nicht definiert wurden, nicht, so daß der Stapel-Zeiger vor der 
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Verzweigung nicht berichtigt werden kann. Es gibt keine effiziente Me- 
thode zur Lösung dieses Dilemma. Daher schließen sich lokale Variable in 
Blöcken (anders als bei Funktionsbeginn) und goto-Anweisungen innerhalb 
einer Funktion gegenseitig aus. 


Die Speicherklasse extern 


Die Speicherklasse extern darf nur bei globalen Deklarationen angegeben 
werden. Wenn die LINK-Option wirksam ist, werden solche Objekte zu 
externen Referenzen für den Assembler erklärt und andere globale Variable 
werden als Einsprungspunkte definiert. Wenn LINK nicht wirksam ist, 
werden externe Variable für den Assembler nicht definiert und andere 
globale Variable werden zwar definiert, aber nicht als Einsprungspunkte. 
Wenn hinter extern nicht int oder char angegeben wird, wird int ange- 
nommen. 


Übergabe der Argumentzahl 


Anders als im Standard-C gibt es bei Small-C für eine Funktions die Mög- 
lichkeit festzustellen, wieviele Argumente ihr übergeben wurden. Wenn 
eine Funktion aufgerufen wird, wird die Zahl der Argumente in den 
Akkumulator geladen. Die Codesequenz dafür benötigt nur zwei Bytes. Um 
die Argumentzahl festzustellen, ruft eine Funktion CCARGC auf und weist 
den zurückgegeben Wert einer Variablen zu. Dies muß als erstes in der 
Funktion geschehen, da andere Operationen Bibliotheksfunktionen aufrufen 
können, die den Akkumulator zerstören. Der Compiler erzeugt keinen 
Code, um die Anzahl der Argument zu laden, wenn CCARGC aufgerufen 
wird. Da viele Programme die Zahl der Argumente nicht übergeben, über- 
geht der Compiler dies in Programmen, die die Anweisung #define NOCC- 
ARGC enthalten. Dies reduziert Programmgröße und Ausführungszeit. Die 
Funktionen printf, fprintf, scanf und fscanf der Small-C-Bibliothek benö- 
tigen die Argumentanzahl. NOCCARGC darf also in Programmen, die diese 
Funktionen aufrufen, nicht verwendet werden. 


Symbole und Namen 


Symbole (Variablennamen usw.) dürfen von beliebiger Länge sein, es sind 
jedoch nur die ersten acht Zeichen signifikant; darüber hinausgehende 
Zeichen sınd erlaubt, werden jedoch ignoriert. Die Namen NamelIndex] 
und Namelndex2 werden also vom Compiler beide wıe NamelInde behan- 
delt. Jeder globale Name erzeugt ein Assemblerlabel gleichen Namens. 
Einige Assembler erlauben nur Label mit einer maxımalen Länge von sechs 
Zeichen und verbieten einige Sonderzeichen und reservierte Symbole. Die 
Namen der CPU-Register und Assembleranweisungen sind beispielsweise 
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nicht erlaubt. Es ist also am Besten, Namen so zu wählen, daß Sıe nıcht mit 
diesen Bezeichnungen in Konflikt geraten und sie innerhalb der ersten 
sechs Zeichen eindeutig zu halten. Ebenso sollten Namen vermieden wer- 
den, die mit U beginnen, da diese von einigen Systemfunktionen verwendet 
werden. Die genannten Probleme existieren bei lokalen Variablen nicht, da 
diese auf dem Stapel gehalten und relativ zum Stapelzeiger adressiert wer- 
den. Globale Namen ın Kleinbuchstaben werden in Großbuchstaben umge- 
wandelt, bevor sie in die Symboltabelle übernommen werden. Symbole ın 
Klein- oder Großbuchstaben sind daher synonym. 


Format der Ausgabedatei 


Der Assemblercode, der vom Small-C-Compiler erzeugt wird, wurde so 
knapp wıe möglich gehalten, damit der Compiler auch auf Systemen mit 
wenig externem Speicherplatz sinnvoll eingesetzt werden kann. Das Assem- 
blerlisting ist deshalb vollkommen unformatiert. Am Anfang einer Zeile 
stehen keine Leerzeichen, auch nicht wenn der erste Teil ein Befehl ist. 
Die einzelnen Bestandteile der Assembleranweisungen werden durch ein 
einziges Leerzeichen getrennt. Es werden in der Ausgabedatei keine Tabs 
verwendet. Das sıeht etwa so aus: 


CC1: 
main:: 
LXI H,-86 
DAD SP 


PUSH H 

LXI H,4096 
PUSH H 

CALL auxbuf 
POP B 

POP B 

LXI H,O 

DAD SP 


CALL CCGINT#H 

PUSH H 

LXI 4,98 

DAD SP 

CALL CCGINT## 

CC2:D8 117,115,97,103,101,58,32,67,80 ,84 


DB 32,107,101,121,10,6,111,117,116.112 
DB 117,116,32,101,114,,114,,111,114,,10,0 
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Kompatibilität zum Standard-C 


Small-C verwendet sowohl Carriage Return als auch Line Feed für das 
Neue-Zeile-Zeichen (newline). Die meisten vollen C-Implementationen 
verwenden Line Feed. Ein Neue-Zeile-Zeichen sollte deshalb immer mit 
der Escapesequenz \n geschrieben werden und nicht als numerische Kon- 
stante. 


Während der Auswertung eines Ausdrucks nımmt der Small-C-Compiler 
an, daß jeder nicht deklarierte Name eıne Funktion ist. Das Standard-C 
nimmt dies nur an, wenn der Name als Funktionsaufruf geschrieben ist, 
das heißt eine Klammer folgt. 


Small-C akzeptiert int arg um eın formales Argument als Funktionsname zu 
definieren und arg(...), um dıe Funktion aufzurufen. Standard-C erfordert 
int (*arg)( ) bzw. (*arg)(...). Die Standard-C-Syntax sollte verwendet wer- 
den, um die Kompatibilität zu wahren. 


Jeder Small-C-Ausdruck, der von einer Klammer ("(") gefolgt wird, wird 
als Funktionsaufruf interpretiert. Wenn diese Möglichkeit verwendet wird, 
kommt es dadurch zu großen Inkompatibilitäten. Während eine Funktion 
wie 256( ) ım Standard-C zurückgewiesen wird, ist sie bei Small-C erlaubt. 
Es wırd daraus der Aufruf einer Routine an der Adresse 256. 


Small-C betrachtet Integer-Konstanten ımmer als dezimale Werte und kennt 
keine oktalen oder hexadezimalen Konstanten. Führende Nullen in Kon- 
stanten sollten in Small-C-Programmen vermieden werden, da sie bei der 
Portierung eines Programms auf einen C-Compiler mit vollem Sprachum- 
fang Probleme verursachen würden. Diese Zahl würde dann für eine oktale 
Zahl gehalten. 


Small-C erlaubt ın oktalen Escapesequenzen (\nnn) nur die Ziffern O bis 7, 
wogegen ım vollen C auch die Ziffern 8 und 9 erlaubt sind (Sie werden 
dort wie die Werte 10 und 11 oktal verarbeitet). 


Alle internen arithmetischen Operationen basieren auf 16-Bit-Integern, was 
bedeutet, daß 8-Bit-char-Elemente vor der Verwendung mit Vorzeichen 
versehen werden. Nicht alle C-Compiler machen dies so, so daß es hier 
(wie auch zwischen anderen Compilern) zu Inkompatibilitäten kommen 
kann. 


Im Gegensatz zum Standard-C gibt es bei Small-C für eine Funktion die 
Möglichkeit festzustellen, wieviele Argumente ihr übergeben wurden. Diese 
Möglichkeit sollte deshalb nur sparsam verwendet werden. 
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Small-C weist mehrere case-Anweisungen mit demselben Wert in einer 
switch-Anweisung nicht zurück, wıe das Standard-C macht. Dies würde 
normalerweise sowieso nur unbeabsichtigt geschehen. 


Die #include-Anweisung von Small-C erfordert keine spitzen Klammern 
oder Anführungszeichen für den Dateinamen. Aus Kompatibilitätsgründen 
sollte jedoch immer #include <stdio.h> (für dıe Standard-Ein-/Ausgabe- 
definitionen) oder #include "datei" (für andere Definitionen) verwendet 
werden. 


Small-C wertet erst die linke Seite einer Zuweisung aus und dann die 
rechte. Das bedeutet, daß Variablen (wie zum Beispiel Indizes), die ver- 
wendet werden, um das Ziel eines zugewiesenen Wertes festzustellen, nıcht 
durch die Auswertung beeinflußt werden. Viele C-Compiler werten erst die 
rechte Seite aus, so daß damit das Objekt ausgewertet werden kann, dem 
etwas zugewiesen wird. Es sollten deshalb Zuweisungen vermieden werden, 
bei denen Variablen auf der linken Seite auch auf der rechten verändert 
werden. 


Small-C wertet Ausdrücke ın der Reihenfolge aus, in der sie geschrieben 
werden. Es ıst deshalb bei der Auswertung möglich, das folgende Variablen 
rechts davon beeinflußt werden. Die Sprachdefinition von C sieht keine 
bestimmte Auswertungsreihenfolge vor, es ist deshalb am Besten, wenn 
Ausdrücke vermieden werden, in denen die Reihenfolge der Auswertung 
dıe auszuwertenden Werte verändert. 


Die Ein-/Ausgabefunktionen von Small-C verwenden zur Identifizierung 
von Dateien Dateideskriptoren, wogegen die Standard-UNIX-Funktionen 
Zeiger verwenden. Dieser Unterschied verursacht jedoch solange keine In- 
kompatibilitäten, wıe die Werte, die an die Ein-/Ausgabefunktionen über- 
geben werden, dieselben sind, die von fopen zurückgegeben wurden oder 
stdin, stdout oder stderr heißen. 


Die Formatanweisungen 5 bei den Bibliotheksfunktionen printf und fprintf 
und die Formatanweisungen 5 und u bei scanf und fscanf sind nur in 
Small-C vorhanden. Ihre Verwendung schränkt also die Portabilität eın. 


Standard-C kann globale und lokale Variablen initialisieren, Small-C nur 
globale Variablen, Arrays und Zeiger. Nicht vorbelegte Objekte werden 
standardmäßig auf bıinär Null gesetzt. 


Anders als ım Standard-C kann man nicht mehr als eine Modifizierung pro 
Deklaration machen, also wird so etwas wie int(*name)[ J] nicht akzeptiert. 
Dies bedeutet keine erhebliche Einschränkung, muß aber erwähnt werden. 
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3 Die Small-C-Bibliothek 


Dieses Kapitel beschreibt die Bibliothek des Small-C-Compilers. Sie wurde 
unter CP/M 2.2 ımplementiert und unterstützt den Small-C-Compiler und 
die von ihm kompilierten Programme. Praktisch sind alle Unix-Funktionen 
verfügbar, die in einer fremden Umgebung anwendbar sind. Natürlich 
werden Standarddateien mit Ein-/Ausgabe-Umleitung und Unix-äÄhnliche 
Übergabe Befehlszeilenparametern unterstützt. Die Bibliothek wird in zwei 
Versionen geliefert, eine für den MACRO-80-Assembler von Microsoft 
(CLIB.REL) und eine für den Small-Mac-Makroassembler (C.LIB), der 
Bestandteil des Small-C-Entwicklungssystems ist (siehe Kapitel 4). 


Bis auf die arithmetische und logische Bibliothek gibt es im Quellcode 
dieser Bibliothek nur etwa 20 Assemblerzeilen. Daher kann man die 
Systemfunktionen sehr viel einfacher verstehen und selbst an andere 
Umgebungen anpassen. 


Organisation der Bibliothek 


Im allgemeinen wird jede Bibliotheksfunktion getrennt kompiliert und 
assembliert und wird dann in eine Bibliothek von verschiebbaren Objekt- 
modulen abgelegt, die CLIB.REL (Microsoft-Version) oder C.LIB (Small- 
Mac-Version) genannt wird. Einige Funktionen, die miteinander in Bezie- 
hung stehen, sind in einem einzigen Modul gruppiert. Beispiele sind print f 
und fprintf und die Systemfunktionen im Modul CSYSLIB. Beim Linken 
wird der Linker (L80 oder LNK) angewiesen, die jeweilige Bibliothek 
(CLIB.REL oder C.LIB) zu durchsuchen, um externe Referenzen aufzu- 
lösen. Alles was gebraucht wird, um ein Programm unter CP/M laufen zu 
lassen wird geladen und mit in die COM-Datei gelinkt. Module, die nicht 
angesprochen werden, werden auch nicht hinzugeladen. Die Größe der 
mindestens zu ladenden Funktionen beträgt etwa 5,5 KByte. 


Da L380 nıcht rückwärts sucht, um ein Modul zu finden, ist die Bibliothek 
CLIB.REL so organisiert, daß rückwärtige Referenzen nur Module einbe- 
ziehen, von denen bekannt ist, daß sıe geladen werden müssen. Sonst wird 
dies alphabetisch organisiert. Der Compiler erzeugt immer eine externe 
Referenz auf Ulink, dıe nur die Deklaration von Umain als extern enthält. 


Dies geschieht als erstes in der Bibliothek und erzwingt, daß CSYSLIB ge- 
laden wırd, was anschließend erfolgt. Das letze Modul ın der Bibliothek ist 
CALL, die arıthmetische und logische Bibliothek. Sie wird zuletzt geladen, 
um den Beginn des freien Speicherplatzes festzustellen. 
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Namen der Systemfunktionen 


Die Namen der Systemfunktionen in der Quelldatei CSYSLIB.C und ihre 
globalen Variablen begannen früher mit dem Unterstrich um Konflikte mit 
Benutzer-Funktionen und Variablennamen zu vermeiden. Ältere Versionen 
von MACRO-80 Versionen akzeptierten diese Namen jedoch nicht als ex- 
terne Referenzen. Deshalb wurde der Unterstrich durch den Buchstaben U, 
der "Unterstrich" bedeutet, ersetzt. 


Initialisierung und Beendigung des Programms 
Der letzte Teıl von CALL enthält folgenden Code: 
Uend: Ihld 6 ‚;bdos Adresse holen 
sphl 


‚als Stackbasis benutzen 
Iixi h,Uend ‚Beginn des freien Speicherplatzes holen 
shld Umemptr## ;für Speicherzuordnung benutzen 
‚m ne ‚Befehlszeile analysieren, Programm ausführen 
e Ue 


Das Label Uend bezeichnet das Programmende und den Beginn des freien 
Speicherplatzes. Durch die letzte Zeile wird angezeigt, daß an dieser Stelle 
auch die Programmausführung beginnt. Die Linker L80 und LNK erzeugen 
am Beginn des Benutzerprogramms einen Sprung auf diese Adresse. Diese 
Logik wird einmal ausgeführt und dann wird dieser Speicherplatz frei für 
dıe Benutzung des Programms. Die Routine Uend setzt: 


l. SP auf die Basis von BDOS, also den CCP überlagernd, 
2. setzt Umemptr auf den Beginn des freien Speichers und 
3. springt nach Umain, um die Programmausführung vorzubereiten. 


Die Funktion Uparse() wird von Umain( ) aufgerufen, um die Analyse und 
die Ein-/Ausgabe-Umlenkung durchzuführen. Zuerst wird die CP/M-Be- 
fehlszeile in einen dynamisch zugeordneten Puffer kopiert und dann mit 
Ufield( ) untersucht, um Argumente zu isolieren und mit Uredirect() um 
die Zuweisungen von stdin und stdout zu ändern (Dateierweiterung mit >> 
wird unterstützt). Wenn eine Umlenkung mißlingt, bricht das Programm 
nach der Anzeige des Buchstabens "R" für Redirection Error (Umlenkungs- 
Fehler) ab. Dann werden argc und argv auf den Stapel gebracht und 
main() wird aufgerufen, um die Programmausführung zu starten. Beı der 
Rückkehr wird exit() mit einem Null-Argument aufgerufen, das den er- 
folgreichen Abschluß anzeigt. Natürlich kann exit({) auch vom Programm 
direkt aufgerufen werden und jeden gewünschten Fehlercode übergeben. 
Der Fehlercode wird, sofern er ungleich Null ıst, als Byte auf dem Bild- 
schirm ausgegeben (7 erzeugt zum Beispiel einen Piepser). Alle offenen 
Dateien werden geschlossen und ein Warmstart durchgeführt. 
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Die BDOS-Schnittstelle 


Eine BDOS-Schnittstelle ist durch die Funktion Ubdos() gegeben. Sie 
braucht zwei Argumente, als erstes den Funktionscode, der ıns C-Register 
geladen wird und den Wert für das Registerpaar DE. Dann wird die Adres- 
se 5 (CP/M) aufgerufen. Bei Rückkehr enthält HL (das primäre Register 
für Small-C) den CP/M-Rückkehrcode vom A-Register. Diese einfache 
Schnittstelle genügt, um die Bibliotheksfunktionen zu realisieren. 


Speicherverwaltung 


Speicher wird ın nicht verketteten, zusammenhängenden Blöcken am Ende 
des Programms zugeordnet. Jeder Aufruf von Ualloc( ) ordnet einen Block 
von auf Null gesetztem bzw. nicht ınitialisiertem Speicher zu, abhängıng 
vom Wert des zweiten Arguments. Die Standardfunktionen malloc( ) und 
calloc( ) rufen Ualloc( ) auf. Speicher kann mit free() oder cfree() wieder 
freigegeben werden. Vorsicht ıst geboten, wenn Speicher in umgekehrter 
Reihenfolge freigegeben wird, wie er zugeordnet worden ist. Beı der Spei- 
cherfreigabe wird einfach ein neuer Wert nach Umemptr gebracht und 
alles, was über dieser Adresse liegt, wird als frei angesehen. Eine Funktion 
mit Namen avail( ) kann aufgerufen werden, um festzustellen, wieviel Platz 
zwischen Umenptr und dem Stapel liegt. Wenn es eine Programm-/Stapel- 
überschneidung gibt, wird avail( ) entweder, wie angefordert, Null zurück- 
geben oder das Programm abbrechen, nachdem der Buchstabe "M" für 
Memory Error (Speicherfehler) angezeigt wurde. Wenn nicht genügend 
Speicher vorhanden ist, brechen malloc( ) und alloc( ) auf diese Art ab. 


Dateiverwaltung 


Die Small-C-Bibliotheksfunktionen identifizieren Dateien mittels kleiner 
Integer-Werte, dıe Dateıideskriptoren genannt werden. Im Gegensatz dazu 
benutzt die Unix-Standard-Bibliothek einen Zeiger auf eine Dateikontroll- 
struktur. Unsere Bibliothek benutzt durchweg die Dateideskriptoren, ob- 
wohl sıe Funktionen der Standard-Ein-/Ausgabe-Bibliothek enthält. Die 
Auswirkung dieser Unterschiede ıst vernachlässigbar, wenn man Datei- 
referenzen auf die Werte beschränkt, die durch die Funktion fopern() zu- 
rückgegeben werden und dıe Symbole stdin, stdout und stderr (definiert in 
der Dateı STDIO.H mit 0, I und 2). Das Symbol MAXFILES ın der Datei 
CLIB.DEF entscheidet, wieviele Dateien zur gleiche Zeit offen sein dürfen. 
Sıeben Integer-Arrays werden entsprechend diesem Wert dimensioniert. Im 
einzelnen sınd dies: 


Ustatus[MAXFILES] 
Dies ıst ein bitcodiertes Statuswort, das anzeigt, ob eine Datei mit dem 
entsprechenden Dateideskriptor geöffnet ist; Null bedeutet geschlossen. 
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Getrennte Bits autorisieren Lesen und Schreiben und es gibt Bits für 
Dateiende und Fehlerbedingungen. 

Udevice[MAXFILES] 
Enthält einen Wert ungleich Null, der eines der logischen Geräte bei 
CP/M bedeutet, wenn mit dem entsprechenden Dateıdeskriptor keine 
Diskettendatei geöffnet ist. 

Ufcbptr[MAXFILES] 
Beim ersten Öffnen einer Datei mit dem Dateideskriptor wird ein 
CP/M-Standard-Dateisteuerblock dynamisch zugeordnet und seine 
Adresse wird hier gespeichert. Wenn die Datei geschlossen wird, bleibt 
der FCB für späteren Gebrauch erhalten. Es seı daran erinnert, daß 
das Verfahren für die Speicherzuordnung zu primitiv ıst, um wahllos 
wieder den Speicher freigeben zu können. Ebenso darf das Programm 
keinen zugeordneten Speicher freigeben, bevor eine Dateı geöffnet 
wird. 

Ubufptr[MAXFILES) 
Wıe beim FCB wird auch ein Puffer zugeordnet, wenn eine Datei ge- 
öffnet wird; ihre Adresse wird hier abgelegt. Auch die Puffer bleiben 
erhalten, wenn die Datei geschlossen wird. 

Uchrpos [MAXFILES] 
Dies ıst ein Offset zum nächsten Byte, das man aus dem entsprechen- 
den Puffer erhält. 
Anmerkung: Der aktuelle Sektor einer Datei wird im Feld für den 
wahlfreien Zugriff im FCB selbst gespeichert und nur die wahlfreien 
Lese- und Schreibzugriffe von CP/M werden durchgeführt. 

Udirty[MAXFILES] 
Ein Nullwert zeigt hier an, daß der entsprechende Puffer neue Daten 
enthält, die noch auf die Diskette geschrieben werden müssen. 

Unextc[MAXFILES] 
Eın Zeichen, das wieder durch unget( ) zur Dateı zurück geschrieben 
worden ıst, wird hier gespeichert. Der Wert EOF (definiert in 
STDIO.H), zeigt ein leeres Feld an, da EOF nicht zurückgeschrieben 
werden kann. 


Bei diesen Arrays wird kein Versuch unternommen, Platz zu sparen, weil 
Small-C bedeutend mehr Code für Zeichenwerte erzeugt als für Integer. 
Weil diese Arrays klein sind, würde mehr Code für das Umsetzen dieser 
Arrays verbraucht werden, als die Zeichenarrays an Platz sparen würden. 


Die Funktion Umode( ) wird intensiv benutzt, sowohl für die Überprüfung, 
ob ein Dateideskriptor gültig ıst, als auch, ob die angegebene Dateı offen 
ist. Wenn der Dateideskriptor gültig ıst, wird der Status der Datei zurück- 
gegeben, sonst wırd Null zurückgegeben. 
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Die Funktion Uopen( ) wird von fopen( ) und freopen( ) aufgerufen. Es wird 
versucht, eine Datei mit dem angegebenen Dateideskriptor zu öffnen. 
Überprüft wird, ob das erste Zeichen im Modus-Argument ein "r" (read, 
lesen), "w" (write, schreiben) oder "a" (append, erweitern) ıst. Wenn der 
Dateiname CON:, LST:, PUN: oder RDR ist, wird dem Dateideskriptor vor 
der Rückkehr einfach das entsprechende logische Gerät zugewiesen. Sofern 
nötig wird sonst der Datei ein FCB und Puffer zugeordnet. Dann wird 
Unewfcb( ) aufgerufen, um: 


l. die Gültigkeit des Dateinamen zu überprüfen, 
2. ıhn ın Großbuchstaben umzusetzen und 
3. den FCB anzulegen. 


Schließlich wırd Ubdos( ) aufgerufen, um dıe Dateı zu öffnen. Wenn gele- 
sen werden soll, wırd der erste Sektor der Dateı (128 Bytes, ein CP/M- 
Satz) automatisch ın den Puffer gelesen. Im Falle des Schreibens wird zu- 
erst eine schon bestehende Datei gelöscht und dann eine neue angelegt. 
Beim Erweitern (Append) wird eine neue Datei angelegt, wenn noch keine 
existiert. Wenn die Dateı schon vorhanden ist, wird sıe geöffnet, dann wird 
die Position des letzten Blocks gesucht und durch wiederholte Aufrufe von 
fgetc() bis EOF (end-of-file) gelesen. Wenn eın Control-Z als Dateiende- 
kennung gefunden wird, wird Uchrpos so ausgerichtet, daß ab dieser Posi- 
tion geschrieben werden kann. Obwohl dieses Verfahren vermeidet, die ge- 
samte Dateı einzulesen, können beı einer Zeichendatei eingebettete Con- 
trol-Z-Zeichen übersehen werden. Wenn dem Modus-Zeichen ein "+" folgt 
(zum Beispiel r+), wird ein Aktualisier-Modus (Update) angenommen und 
Ustatus wırd auf Lesen und Schreiben gesetzt. Diese neue Merkmal von 
Unix/C wird von C.D. Perez ın "A Guide to the C Library for Unix Users" 
dokumentiert. Offensichtlich muß man in Unix/C fseek() oder rewind( ) 
aufrufen, wenn man zwischen Lesen und Schreiben wechseln möchte. Die 
Small-C-Bibliothek erlaubt jedoch ein uneingeschränktes Wechseln zwi- 
schen Lesen und Schreiben; jede Operation beginnt mit dem Byte, das dem 
letzten übertragenen folgt. Da Small-C keine Long-Integer unterstützt, wird 
auch fseek( ) nicht unterstützt. Stattdessen kann man cseek( ) zur Positionie- 
rung auf CP/M-Satzgrenzen benutzen. 


Wenn beım Lesen das Dateiende gefunden wırd, wird das EOÖF-Bit ın 
Ustatus gesetzt und weiteres Lesen verhindert. Schreiben ist jedoch erlaubt. 
Das EOF-Bit wird beı erfolgreicher Suche oder durch rewind wıeder ge- 
löscht. Dateiöffnung ım Schreibe- oder Erweiterungsmodus setzt das EOF- 
Bit automatisch. Dateien kann man entweder durch Öffnen im Erweite- 
rungs-Modus oder durch Öffnen im Modus Lesen/Aktualiseren durch 
Lesen bis zum Dateiende mit anschließendem Schreiben erweitern. 


34 Die Small-C-Bibliothek 


Unix führt nur binäre Dateiübertragungen durch und das Dateiende wird 
als Zeiger in der Verzeichnis-Struktur gespeichert. Es ıst Aufgabe der 
Gerätetreiber, zwischen dem Zeichen Neue-Zeile, und der Kombination 
aus Wagenrücklauf (Carriage Return) und Zeilenvorschub zu unterscheiden. 
Diesem Verfahren kann jedoch unter CP/M nicht gefolgt werden. Erstens 
gibt es im CP/M-Dateiverzeichnis keinen Platz für einen Dateiende-Zeiger. 
Dann muß aus ASCII-Datei-Kompatibilitätsgründen mit anderer CP/M- 
Software Control-Z als Endekennung verwendet werden und das Zeichen 
Neue-Zeile muß bei der Ausgabe in eine Kombination aus Carriage Return 
und Line Feed übersetzt werden (bei der Eingabe umgekehrt). Daher war 
es erforderlich, ein Unterscheidungsmerkmal zwischen (binären) Byte- und 
ASCII-Zeichen zu schaffen. Die Absıcht der C-Entwickler wäre nicht ver- 
letzt worden, wenn man dafür andere, nicht-Unix-kompatible Öffnungs- 
Modi angegeben hätte. Es wurde jedoch vorgezogen die Standard-Öff- 
nungsprozeduren beizubehalten und stattdessen zwischen den Ein-/Aus- 
gabe-Funktionen zu unterscheiden. In der Small-C-Bibliothek übertragen 
read( ), fread( ), write( ), und fwrite() dıe Daten binär. Alle anderen Auf- 
rufe (zum Beispiel getc( ), fgets() und so weiter) übertragen ASCII-Zei- 
chen. Dadurch werden Small-C-Programme aufwärtskompatibel zu Unix, 
ohne die Öffnungsmodi zu ändern. 


Binäres Lesen findet das Dateiende nur am Ende des letzten Sektors ın der 
Datei. Das ist notwendigerweise abweichend von Unix, wo das Ende einer 
Datei auf das Byte genau angegeben werden kann. 








Uread Uwrite 
den || eg 
+-- 0000. ob #er--...n- + 
ı Uputsec 
+--..-.-..- 4-00 0n0n. ! 
fflush 
| 
nun nen + 
+- 000.0... (|)----------- + 
Uconin aa Usector Unewbuf Uconout 
+-.... +--- rennen nenn. | a nn +-...-. + 
Ubdos 


In der obigen Abbildung sind die primären Eın-/Ausgabe-Funktionen dar- 
gestellt. Linien, die die Funktionsnamen verbinden, kennzeichnen den 
möglichen Kontrollfluß. Alle Ein-/Ausgabe-Anforderungen gehen ent- 
weder durch Uread({ ) oder Uwrite( ). Diese führen nur binäre Datenübertra- 
gungen durch, Byte für Byte. Die Logik für zeichenweise Datenübertragung 
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ist in fgetc() und fputc( ), die wiederum von anderen zeichenorientierten 
Funktionen aufgerufen werden. 


Die Funktionen Uconin() und Uconout( ) sind für Übertragungen von und 
zur Konsole (Bildschirm/Tastatur) zuständig. Für diese Übertragung wird 
die direkte Konsol-Ein-/Ausgabe von CP/M benutzt. Bei der Ausgabe hat 
der Terminaltreiber volle Kontrolle über das Programm. Außerdem kann so 
die Tastatur zuverlässig auf Eingaben des Benutzers abgefragt werden, 
während noch Daten zum Bildschirm geschrieben werden. Wäre konventio- 
nelle Konsol-Ein-/Ausgabe benutzt worden, hätte CP/M auch Kontroll- 
zeichen abgefragt und es wäre reine Glückssache gewesen, wer das Ein- 
gabezeichen erhalten hätte. Folge dieser Wahl war, daß die üblichen Tasta- 
tureingaberoutinen (echo, rubout und so weiter) ın Uconin() und fgets() 
integriert werden mußten. Wenn man sich die Routinen ansıeht, hielten 
sich die Kosten in Grenzen. 


Wie ihre Namen schon vermuten lassen übertragen Ugetsec( ) und Uputsec{ ) 
einen Sektor zwischen Puffer und Diskette. Sie werden aufgerufen, wenn 
die Puffer voll werden oder leer sınd. Einen Sektor zu holen setzt voraus, 
daß der Puffer zuerst auf die Diskette geschrieben wird, wenn er neue 
Daten enthält. Als nächstes wird dıe wahlfreie Satzzahl des FCB (RRN) 
durch Aufruf von Uadvance( ) weitergestellt. Schließlich werden die Daten 
durch Aufruf von Usector() (wobei Ubdos aufgerufen wird) übertragen. 
Der Dateiendestatus wird gesetzt, wenn der Versuch mißlingt. Einen Sektor 
zu schreiben unterscheidet sich vom Lesen um mehr als nur die Umkeh- 
rung des Datenflusses. Die Reihenfolge der Aufrufe von Usector( ) und 
Uadvance( ) wırd umgekehrt, da der RRN jetzt die Position in der Datei 
beschreibt, wohın der neu gefüllte Puffer geschrieben werden sollte. Nach 
der Datenübertragung wird Unewbuf( ) aufgerufen um den Puffer ın Er- 
wartung weiterer Uwrite( )-Aufrufe mit Control-Z-Zeichen aufzufüllen. 


Die Ugetsec( )„-Funktion erlaubt das Lesen von Diskettenverzeichnissen. Ein 
Verzeichnis wird als ASCII-Dateı mit Dateinamen angesehen, einer pro 
Zeile. Ein Verzeichnis wird durch eine Laufwerksangabe ohne Dateiname 
angezeigt. Durch die Bezeichnung B: erhält man zum Beispiel das Verzeich- 
nis des Laufwerks B. X: bedeutet das aktuelle Verzeichnis. Fopen() und 
freopen() akzeptieren diese Verzeichnisnamen genau wie jeden anderen 
Namen. Verzeichnisnamen können auch benutzt werden, um die Standard- 
eingabe umzulenken. Verzeichnisdateien können nur gelesen werden; beim 
Schreiben erhält man einen Fehler. /satty( ) antwortet mit YES beı Ver- 
zeichnisdateien, cseek() gibt EOF zurück, fflush() macht nichts und ur- 
getc() arbeitet wıe üblich. Diese Merkmale benötigen 0.3KB, die durch 
Löschen von #define DIR ın CSYSLIB.C vor der Kompilierung der Small- 
C-Bibliothek entfernt werden können. 
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Die Funktionen 


Die meisten Funktionen auf Benutzerebene sind nach ihren Unix-Gegen- 
stücken angelegt worden. Einige sind jedoch extra für diese Bibliothek ge- 
schaffen und als Small-C-Funktionen gekennzeichnet worden. Hier einige 
wichtige Symbole, die ın STDIO.H definiert werden: 

#define stdin O0 /* Dateideskriptor für Standardeingabe */ 

#define stdout 1 /* Dateideskriptor für Standardausgabe */ 

#define stderr 2 /* Dateideskriptor für Standardfehlerausgabe */ 

#Adefine ERR -2 /* Rückgabewert bei Fehlerbedingung */ 


#define EOEFU 4-1 /* Rückgabewert bei Dateiende */ 
#define NULL 0 /* Wert eines Null-Zeichens */ 


Ein-/Ausgabe-Funktionen 
fopen(name, mode) char *name, *mode; 


Diese Funktion versucht die Dateı zu öffnen, die durch die mit Null abge- 
schlossene Zeichenkette name angegeben wird. Mode zeigt auf eine Zei- 
chenkette, dıe anzeigt, wıe die zu Öffende Dateı benutzt werden soll. Die 


Werte für mode sind “r" (lesen, read), "w" (schreiben, write) und "a 
(erweitern, append). 


Bei "r" wird eine schon existierende Datei für die Eingabe geöffnet, "w" 
legt entweder eine neue Dateı an oder löscht eine schon bestehende, so daß 
vom Anfang der Datei geschrieben wird. Bei "a" kann man am Ende einer 
Datei noch weiter schreiben (oder am Anfang einer neuen). Zusätzlich kann 
man eine Datei auch noch aktualisieren (sowohl schreiben als auch lesen). 
Die Parameter dafür heißen "r+" (aktualisieren lesen), "w+" (aktualisieren 
schreiben) und "a+" (aktualisieren erweitern). 


Diese Parameter verhalten sich bei einer Dateieröffnung genauso, wie ihre 
Gegenstücke ohne Aktualisierung, sie erlauben es jedoch, daß zwischen 
read( ) und write( ) gewechselt werden kann, indem man abwechselnd Ein- 
und Ausgabe-Funktionen aufruft. Wenn das Programm kein seek oder re- 
wind durchführt, wird der nächste Schreib- oder Lesevorgang an der Stelle 
beginnen, an der der vorige geendet hatte. 


Wenn die Datei erfolgreich eröffnet wurde, gibt fopen() einen Dateides- 
kriptor für die offene Datei zurück, sonst NULL. Dieser Dateideskriptor 
wird dann für alle folgenden Ein-/Ausgabefunktionen dieser Datei ver- 
wendet. Nur die Standard-Dateien können benutzt werden, ohne vorher 
fopen( ) aufzurufen. 


freopen(name, mode, fd) char *name, *mode; int fd; 


Diese Funktion schließt eine zuvor geöffnete Datei, die durch den Dateı- 
deskriptor fd angegeben wird, und Öffnet eine neue, deren Name ın der 
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mit Null beendeten Zeichenkette name steht. Mode zeigt auf die Zeichen- 
kette, die den Öffnungsmodus angibt (die den Modi von fopen( ) entspre- 
chen). Zurückgegeben wird beı Erfolg der ursprüngliche Dateideskriptor fd 
oder NULL, wenn die alte Datei nicht geschlossen oder wenn die neue 
nicht geöffnet werden konnte. Man muß jedoch darauf achten, daß man ın 
diesem Fall nıcht zwischen Erfolg und Mißerfolg unterscheiden kann, da 
der Dateideskriptor fd für die Standardeingabe Null ist. 


fclose(fd) int fd; 


Diese Funktion schließt die angegebene Datei. Wenn sich noch neue Daten 
im Puffer der Dateı befinden, werden sie zuerst ın die Dateı geschrieben. 
Bei Erfolg wird NULL, bei Fehler ein Wert ungleich Null zurückgegeben. 


fgetc(fd) int fd; (alias getc) 


Diese Funktion gıbt das nächste Zeichen aus der Dateı zurück, die durch 
fd angegegben wird. Wenn keine weiteren Zeichen mehr ın der Datei vor- 
handen sınd oder wenn eın Fehler auftritt, wird EOF zurückgegeben. Das 
Dateiende wird entweder durch das implementationsabhängige Dateiende- 
Zeichen gefunden oder durch das physikalische Ende der Dateı. 


ungetc(c, fd) char c; int fd; 


Diese Funktion stellt logisch (nıcht physikalisch) das Zeichen c ın die Dateı 
zurück, die durch fd angegegben wird. Beim nächsten Lesen aus dieser 
Datei wird dieses Zeichen zuerst geholt. Nur ein Zeichen auf eınmal kann 
so in Wartestellung gehalten werden. Bei Erfolg wırd das Zeichen selbst 
zurückgegeben oder EOF, wenn ein vorher zurückgestelltes Zeichen wartet 
oder wenn c den Wert EOF hat. EOF kann nicht in eine Datei zurückge- 
stellt werden. Bei einem seek- oder rewind-Vorgang wird das zurückge- 
stellte Zeichen vergessen. 


getchar() 
Diese Funktion entspricht /getc(stdin). 
fgets(str, sz, fd) char *str; int sz, fd; 


Diese Funktion liest bis zu sz-] Zeichen aus einer Datei, dıe durch fd ge- 
kennzeichnet wird, ab Adresse str. Durch Übertragung des Zeichens Neue- 
Zeile wird die Eingabe beendet. Ein Null-Zeichen wird nach dem ersten 
Neue-Zeile-Zeichen oder an die letzte Stelle angehängt, wenn Neue-Zeile 
nicht gefunden wird. Fgets( ) gibt bei Erfolg str zurück, bei Dateiende oder 
Fehler NULL. 
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fread(ptr,sz,cnt,fd) char *ptr; int sz, cnt, £d; 


Diese Funktion liest aus der durch fd angegebenen Datei cnt Datensätze ın 
einer Länge von sz Bytes ab Adresse ptr. Die Anzahl der tatsächlich gelese- 
nen Sätze wird an der Aufrufer zurückgegeben. Dies kann weniger als cnt 
sein, wenn vorher das Dateiende gefunden wurde. Diese Funktion führt 
eine binäre Übertragung durch, Sequenzen aus Carriage-Return und Line- 
feed werden nicht in Neue-Zeile-Zeichen umgewandelt und auf eın Datei- 
ende-Byte wird nicht geachtet. Erkannt wird nur das physikalische Ende 
einer Datei. Man sollte feof() aufrufen, um sicherzugehen, daß keine 
Daten mehr da sind und ferror( ), um Fehlerbedingungen zu entdecken. 


read(fd, ptr, cnt) int fd, cnt; char *ptr; 


Diese Funktion liest aus einer durch /d angegebenen Datei cnt Bytes ab 
Adresse ptr. Die Anzahl der tatsächlich gelesenen Bytes wird an der Auf- 
rufer zurückgegeben. Dies kann weniger als crt sein, wenn vorher das 
Dateiende gefunden wurde. Diese Funktion führt eine binäre Übertragung 
durch, Sequenzen aus Carrıiage-Return und Linefeed werden nicht ın 
Neue-Zeile-Zeichen umgewandelt und auf ein Dateiende-Byte wird nicht 
geachtet. Erkannt wird nur das physikalische Ende einer Datei. Man sollte 
feof() aufrufen, um sicherzugehen, daß keine Daten mehr da sind und 
ferror( ), um Fehlerbedingungen zu entdecken. 


gets(str) char *str; 


Diese Funktion liest Zeichen von stdin an die Adresse str. Die Eingabe 
wird beendet, wenn ein Neue-Zeile-Zeichen gefunden wird, das Zeichen 
selbst wird jedoch nicht übertragen. Ein Null-Zeichen beendet die Ein- 
gabezeichenkette. Gets() gibt bei Erfolg str zurück, bei Dateiende oder 
Fehler NULL. Da diese Funktion eine beliebige Datenmenge übertragen 
kann, muß man die Größe der Eingabezeichenkette prüfen, um sicherzu- 
stellen, daß der zugewiesene Platz nicht überschritten wurde. 


feof(fd) int fd; 


Diese Funktion gibt einen Wert ungleich Null zurück, wenn die durch /d 
angegebene Datei ihr Ende erreicht hat. Sonst wird NULL zurückgegeben. 


ferror(fd) int fd; 


Diese Funktion gibt einen Wert ungleich Null zurück, wenn bei der durch 
fd angegebenen Datei seit ihrer Öffnung eine Fehlerbedingung aufgetreten 
ist. Sonst wırd NULL zurückgegeben. 
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clearerr(fd) int fd; 


Diese Funktion löscht den Fehlerstatus der Datei, die durch fd gekenn- 
zeichnet wird. 


fputc(c, fd) char c; int fd; (alias putc) 


Diese Funktion schreibt das Zeichen c auf die durch fd gekennzeichnete 
Dateı. Bei Erfolg wird das Zeichen selbst zurückgegeben, sonst EOF. Wenn 
c ein Neue-Zeile-Zeichen ist, wird ein Carriage-Return/Linefeed-Paar ge- 
schrieben. 


putchar(c) char c; 
Diese Funktion entspricht fputc(c,stdout). 
fputs(str, fd) char *str; int fd; 


Diese Funktion schreibt Zeichen ab Adresse str zur Datei fd. Es werden 
solange aufeinanderfolgende Zeichen geschrieben, bıs ein Null-Byte gefun- 
den wird. Das Null-Byte wird nicht geschrieben und eın Neue-Zeile-Zei- 
chen wird nicht hinzugefügt. 


puts(str) char *str; 


Diese Funktion arbeitet wie fputs(str, stdout), nur daß noch eın Neue- 
Zeile-Zeichen angefügt wird. 


fwrite(ptr,sz,cnt,fd) char *ptr; int sz, cnt, fd; 


Diese Funktion schreibt auf die durch /d gekennzeichnete Dateı cnt Sätze 
ın der Länge von sz Bytes ab Speicheradresse ptr. Die Anzahl der geschrie- 
benen Sätze wırd zurückgegeben. Durch eine Fehlerbedingung kann die 
Zahl der geschrieben Sätze kleiner als cnt sein. Man sollte ferror( ) auf- 
rufen, um Fehlerbedingungen festzustellen. Diese Funktion führt eine 
binäre Übertragung durch; Neue-Zeile-Zeichen werden nicht in Carriage- 
Return/Linefeed-Sequenzen umgewandelt. 


write(fd, ptr, cent) int fd, cnt; char *ptr; 


Diese Funktion schreibt auf die durch fd gekennzeichnete Datei cnt Bytes 
ab Speicheradresse pir. Die Anzahl der geschriebenen Bytes wird zurück- 
gegeben. Durch eine Fehlerbedingung kann die Zahl der geschrieben Bytes 
kleiner als cnt sein. Man sollte ferror( ) aufrufen, um Fehlerbedingungen zu 
finden. Diese Funktion führt eine binäre Übertragung durch; Neue-Zeile- 
Zeichen werden nicht ın Carriage-Return/Linefeed-Sequenzen umgewan- 
delt. 
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fflush(fd) int.fg; 


Diese Funktion erzwingt, daß alle systemgepufferten Änderungen in die 
Datei geschrieben werden. Gewöhnlich werden die in eine Dateı zu schrei- 
benden Daten in einem Puffer gehalten, bis 1.) der Puffer voll wırd, 2.) 
der Puffer für einen anderen Datensektor gebraucht wird oder 3.) die Datei 
geschlossen wird. Fclose( ) ruft diese Funktion auf. Bei Erfolg gibt fflush( ) 
NULL zurück, bei Fehler EOF. 


cseek (fd, offset, from) int fd, offset, from; 


Diese Small-C-Funktion stellt die durch fd gekennzeichnete Datei auf den 
Anfang des 128 Byte-Satzes, der offset Sätze vom ersten Satz, aktuellen 
Satz oder Dateiende entfernt ıst, je nachdem ob from 0, 1 oder 2 ist. 
Nachfolgendes Lesen oder Schreiben beginnt an diesem Punkt. Beı Erfolg 
wird NULL zurückgegeben, sonst EOF. 


rewind(fd) int fd; 


Diese Funktion stellt die durch fd gekennzeichnete Datei auf den Anfang. 
Das entspricht einem cseek nach dem ersten Satz der Dateı. Bei Erfolg wird 
NULL, sonst EOF zurückgegeben. 


ctell(fd) int fd; 


Diese Small-C-Funktion gibt die Nummer des aktuelle Satzes einer Datei 
zurück, dıe durch fd angezeigt wird. Der zurückgegebene Wert ıst der Ab- 
stand des aktuellen 128-Byte-Satzes vom ersten Satzes in der Datei. Wenn 
fd keiner Diskettendatei zugewiesen war, wird -1 zurückgegeben. 


unlink(name) char *name; (alias delete) 


Diese Funktion löscht die Datei, die durch die mit Null beendete Zeichen- 
kette in name angegeben ist. Bei Erfolg wird NULL, sonst ERR zurück- 
gegeben. 


rename (old, new) char *old, *new; 


Diese Small-C-Funktion ändert den mit old angegeben Dateinamen in den 
mit new angegebenen. Bei Erfolg wird NULL sonst ERR zurückgegeben. 


auxbuf(fd, size) int fd, size; 


Diese Funktion ordnet fd einen Hilfspuffer der Größe size Bytes zu. Bei 
Erfolg wird NULL, bei Fehler ERR zurückgegebenen. fd muß geöffnet 
sein. Size muß größer als Null und kleiner als der verfügbare Speicherplatz 
sein. Wenn fd ein Gerät ist, wird zwar der Puffer zugeordnet, aber igno- 
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riert. Zusätzlicher Puffer ist nützlich, wenn die Bewegung des Disketten- 
kopfes oder während sequentieller Operationen der häufige Wechsel zwi- 
schen Laufwerken verringert werden soll. Wenn ein Hilfspuffer einmal zu- 
geordnet ist, bleibt er während der Programmausführung zugeordnet, auch 
wenn fd geschlossen wird. Beim zweiten Aufruf dieser Funktion mit dem 
gleichen fd wird ERR zurückgegeben, was jedoch keine Auswirkungen hat. 
Abwechselnde Schreib-/Leseoperationen oder seeks führen zu nicht vor- 
hersehbaren Ergebnissen. Ungetc( ) wird jedoch normal arbeiten. 


iscons(fd) int fd; 


Diese Small-C-Funktion gibt einen Wert ungleich Null zurück, wenn fd 
der Konsole zugeordnet ist, sonst NULL. 


isatty(fd) int fd; 


Diese Funktion gibt einen Wert ungleich Null zurück, wenn fd einem Ge- 
rät statt einer Dateı zugewiesen ist, sonst NULL. 


Funktionen für formatierte Ein-/Ausgabe 
printf(str, argl, arg2, ...) char *#str; 


Diese Funktion schreibt auf die Standardausgabe eine formatierte Zeichen- 
kette, die aus einer mit Null abgeschlossenen Zeichenkette s/r besteht, die 
an spezifizierten Punkten mit den Zeichenkettenäquivalenten der Argumen- 
te argl, arg2... verknüpft ıst. Zurückgegeben wird die Gesamtanzahl der 
geschriebenen Zeichen. Die Zeichenkette sir wird auch als Kontrollzeichen- 
kette bezeichnet. Sie muß angegeben werden, die anderen Parameter sind 
optional. Die Kontrollzeichenkette enthält gewöhnliche Zeichen und Zei- 
chengruppen, die auch als Umwandlungsanweisung bezeichnet werden. Jede 
dieser Anweisungen sagt printf( ), wıe das entsprechende Argument in eine 
Zeichenkette für die Ausgabe umgewandelt wird. Bei der Ausgabe ersetzt 
das umgewandelte Argument die Umwandlungsanweısung. Das Zeichen % 
signalisiert den Beginn einer Umwandlungsanweisung und einer der Buch- 
staben 5b, c, d, 0, s, u oder x beendet sıe. 


In der angegebenen Reihenfolge und ohne Leerstellen dazwischen darf ein 
Minuszeichen (-) auftreten, eine dezimale Integer-Konstante (nnn) 
und/oder ein Dezimalbruch (.mmm). Diese Unterfelder sınd alle optional. 
Tatsächlich kann man häufig Umwandlungsanweisungen ohne sie antreffen. 
Das Minuszeichen bedeutet, daß die aus dem Argument durch Anwendung 
einer bestimmten Umwandlungsanweisung erzeugte Zeichenkette im Aus- 
gabefeld linksbündig erscheinen muß. 
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Die dezimale Integer gibt die Mindestbreite dieses Feldes (in Zeichen) an. 
Wenn mehr Platz gebraucht wird, wird er benutzt, mindesten wird jedoch 
die angegebene Zahl der Positionen erzeugt. Der Dezimalbruch wird be- 
nutzt, wenn das umzuwandelnde Argument selbst eine Zeichenkette ist 
(genauer, die Adresse einer Zeichenkette). In diesem Fall gibt der Dezimal- 
bruch an, wieviele Zeichen maximal aus der Zeichenkette genommen wer- 
den können. Wenn ın dem Ausdruck kein Dezimalbruch vorhanden ist, 
wird die gesamte Zeichenkette benutzt. 


Der Buchstabe am Ende gibt die Art der anzuwendenden Umwandlung auf 
das Argument an. Er kann einer der folgenden sein: 


b Das Argument wird als Integer ohne Vorzeichen betrachtet und für die 
Ausgabe ins binäre Format umgewandelt. Führende Nullen werden 
nicht erzeugt. Diese Spezifikation gibt es nur in Small-C und beı der 
Anwendung sollte man das berücksichtigen. 

c Dieses Argument wird als Zeichen ohne Umwandlung ausgegeben. In 
diesem Fall wird das höherwertige Byte ignoriert. 

d Das Argument wird als Integer mit Vorzeichen angesehen und und für 
die Ausgabe in eine dezimale Zeichenkette (möglicherweise mit Vor- 
zeichen) umgewandelt. Führende Nullen werden nicht erzeugt. Das 
Vorzeichen steht am weitesten links; es ist leer für positive und "-" für 
negative Zahlen. 

o Das Argument wird als Integer ohne Vorzeichen gesehen und für die 
Ausgabe ins oktale Format umgewandelt. Führende Nullen werden 
nicht erzeugt. 

s Das Argument ist die Adresse einer mit Null abgeschlossenenen Zei- 
chenkette, die ausgegeben wird wie sıe ıst. Die angegebene Ausrich- 
tung, Mindestbreite und maximale Größe werden jedoch berücksich- 
tigt. 

u Das Argument wird als Integer ohne Vorzeichen gesehen und für die 
Ausgabe ın eine dezimale Zeichenkette ohne Vorzeichen umgewandelt. 
Führende Nullen werden nicht erzeugt. 

x Das Argument wird als Integer ohne Vorzeichen gesehen und für die 
Ausgabe ins hexadezimale Format umgewandelt. Führende Nullen wer- 
den nicht erzeugt. 


Wenn dem % irgendetwas anderes als eine gültige Angabe folgt, wırd das 
ignoriert und das nächste Zeichen wird ohne Änderung ausgegebenen. 
Durch %% erhält man %. 


Printf( ) durchsucht die Kontrollzeichenkette von links nach rechts und gibt 
alles auf stdout aus, bis ein % gefunden wird. Dann wird die folgende Um- 
wandlungsanweisung ausgewertet und auf das erste Argument angewendet, 
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das der Kontrollzeichenkette folgt. Die sich ergebende Zeichenkette wird 
nach stdout geschrieben. Anschließend werden wieder Daten aus der Kon- 
trollzeichenkette geschrieben bis eine andere Umwandlungsanweisung ge- 
funden wird, die dann auf das zweite Argument angewendet wird. Diese 
Prozedur geht weiter, bis die Kontrollzeichenkette erschöpft ist. Als Ergeb- 
nis erhält man eine formatierte Ausgabe, die aus Literalen und varıablen 
Daten besteht. 


fprintf(fd,str,argl,arg2, ...) int fd; char *#str; 


Diese Funktion arbeitet wie printf( ), nur daß die Ausgabe zur durch fd 
angegebenen Datei geht. 


scanf(str, argl, arg2, ...) char *str; 


Diese Funktion liest eine Folge von Feldern von der Standardeingabe, wan- 
delt sıe ın internes Format entsprechend der ın der Kontrollzeichenkette str 
enthaltenen Umwandlungsanweisung um und speichert sıe an den durch die 
Argumente arg], arg2... angegebenen Plätzen. Zurückgegeben wird dıe Zahl 
der gelesenen Felder. Eın Feld beı der Eingabe ıst eine zusammenhängende 
Kette von Grafikzeichen. Beendet wird es durch das nächste Leerzeichen 
(Leerstelle, Tab oder Neue-Zeile) oder, wenn die Umwandlungsanweiısung 
eine maximale Feldlänge angibt, wenn diese Feldlänge erschöpft ist. Nor- 
malerweise beginnt ein Feld mit dem ersten Grafikzeichen nach dem vori- 
gen Feld; demnach werden Leerzeichen übergangen. Da das Neue-Zeile- 
Zeichen übersprungen wird, wenn das nächste Feld gesucht wird, liest 
scanf( ) soviele Eıngabezeilen wie erforderlich sind, um die Zahl der Um- 
wandlungsanweısungen ın der Kontrollzeichenkette abarbeıten zu können. 
Jedes der Argumente, das der Kontrollzeichenkette folgt, muß eine Adresse 
ergeben. 


Die Kontrollzeichenkette enthält Anweisungen für die Umwandlung und 
Leerzeichen (die ignoriert werden). Jede Umwandlungsanweisung sagt 
scanf( ), wıe das entsprechende Feld ın internes Format umgewandelt wer- 
den soll und jedes s/r folgende Argument gibt die Adresse an, wo der Wert 
gespeichert werden soll. 


Das Zeichen % signalisiert den Begınn einer Umwandlung und einer der 
Buchstaben >, c, d, 0, s, u oder x beendet sie. 


In der angegebenen Reihenfolge und ohne Leerstellen dazwischen kann eın 
Stern (*) auftreten und/oder eine dezimale Integer-Konstante. Diese Unter- 
felder sind beide optional. Tatsächlich kann man häufig Umwandlungsan- 
weisungen antreffen, die keines von beiden benutzen. Der Stern bedeutet, 
daß das entsprechende Feld bei der Eingabe übersprungen wird. Aus- 
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lassungsanweisungen haben keine Argumente. Das numerische Feld gibt die 
maximale Feldbreite ın Zeichen an. Wenn vorhanden, wird das Feld bei der 
angegebenen Zahl der zu durchsuchenden Zeichen beendet, sogar wenn 
kein Leerzeichen gefunden wurde. Wenn jedoch ein Leerzeichen gefunden 
wird, bevor die Feldbreite erschöpft ist, wird das Feld an diesem Punkt 
beendet. 


Der Buchstabe am Ende gibt die Art der anzuwendenden Umwandlung auf 
das Argument an. Er kann einer der folgenden sein: 


b Das Feld wird als binäre Integer angesehen und für die Ausgabe in 
einen Integerwert umgewandelt. Das entsprechende Argument sollte 
eine Integeradresse sein. Führende Nullen werden ignoriert. Diese 
Spezifikation gibt es nur in Small-C und bei der Anwendung sollte 
man das berücksichtigen. 

ce Dieses Feld wird als einzelnes Zeichen ohne Umwandlung akzeptiert. 
Die Angabe verhindert das normale Auslassen von Leerzeichen. Das 
Argument für so ein Feld sollte eine Zeichenadresse sein. 

d Das Eingabefeld wird als dezimaler Integer (möglicherweise mit Vor- 
zeichen) angesehen und in einen Integerwert umgewandelt. Führende 
Nullen werden ignoriert. 

o Das Feld wird als oktaler Integer angesehen und ın einen Integerwert 
umgewandelt. Das entsprechende Argument sollte eine Integeradresse 
sein. Führende Nullen werden ignoriert. 

s Das Feld sollte als Zeichenkette angesehen werden und mit einer Null 
am Ende an der Zeichenadresse ihres Argumentes gespeichert werden. 
An der Adresse muß genug Platz für die Zeichenkette und die Null 
vorhanden sein. Man sollte daran denken, daß man eine maximale 
Feldbreite angeben kann, um einen Überlauf zu verhindern. Die An- 
gabe %/s wird das nächste Grafikzeichen lesen, wo hingegen %c das 
nächste Zeichen liest, was auch immer es ist. 

u Das Argument wird als dezimaler Integer ohne Vorzeichen angesehen 
und in einen Integerwert umgewandelt. Das entsprechende Argument 
sollte eine Integeradresse sein. Führende Nullen werden ignoriert. 
Diese Spezifikation gibt es nur in Small-C und bei der Verwendung 
sollte man das berücksichtigen. 

x Das Feld wird als hexadezimale Zahl angesehen und ın einen Integer- 
wert umgewandelt. Das entsprechende Argument sollte eine Integer- 
adresse sein. Führende Nullen oder 0x oder 0X werden ignoriert. 


Scanf() durchsucht die Kontrollzeichenkette von links nach rechts und 
verarbeitet Eingabefelder bis die Kontrollzeichenkette erschöpft ist oder ein 
Feld gefunden wird, das mit den Umwandlungsanweisungen nicht überein- 
stimmt. Wenn der von scanf( ) zurückgegebene Wert kleiner als die Anzahl 
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der Umwandlungsanweisungen ist, trat entweder ein Fehler auf oder das 
Ende der Eingabedatei ist erreicht worden. Wenn keine Felder verarbeitet 
wurden, wird EOF zurückgegeben, da das Dateiende erreicht wurde. 


fscanf(fd, str, argl, arg2, ...) int fd; char *str; 


Diese Funktion arbeitet wie scanf( ), nur wird die Eingabe aus der Dateı fd 
genommen. 


Funktionen für Formatkonvertierungen 
atoi(str) char *str; 


Diese Funktion wandelt die dezimale Zahl, die durch die Zeichenkette str 
dargestellt wird, in eine Integer um und gibt ihren Wert zurück. Führende 
Leerzeichen werden übergangen und wahlweise kann der am weitesten 
links stehenden Ziffer ein Vorzeichen vorausgehen (+ oder-). Das erste 
nicht-numerische Zeichen beendet die Umwandlung. 


atoib(str, base) char *str; int base; 


Diese Small-C-Funktion wandelt eine Integer ohne Vorzeichen mit Basıs 
base, die durch die Zeichenkette s{r dargestellt wird, ın einen Integer um 
und gibt den Wert zurück. Führende Leerzeichen werden übersprungen. 
Das erste nicht numerische Zeichen beendet die Umwandlung. 


itoa(nbr, str) int nbr; char #str; 


Diese Funktion wandelt eine Zahl ın nbr in eine dezimale Zeichenkette in 
str um. Das Ergebnis wird in str links ausgerichtet, mit führendem Minus- 
zeichen wenn nbr negativ ıst. Ein Null-Zeichen beendet die Zeichenkette, 
die groß genug sein muß, um das Ergebnis aufnehmen zu können. 


itoab(nbr, str, base) int nbr; char *str; int base; 


Diese Small-C-Funktion wandelt die Integer nbr ohne Vorzeichen in die 
entsprechende Zeichenkettendarstellung ın sfr mıt Basıs base um. Das Er- 
gebnis wird ın str links ausgerichtet. Ein Null-Zeichen beendet die Zei- 
chenkette, die für das Ergebnis groß genug sein muß. 


dtoi(str, nbr) char *str; int *nbr; 


Diese Funktion wandelt eine dezimale Zahl (eventuell mit Vorzeichen) ın 
der Zeichenkette str in eine Integer ndr um und gibt die Länge des gefun- 
denen numerischen Feldes zurück. Die Umwandlung wird beendet, wenn 
das Ende der Zeichenkette oder ein ungültiges Zeichen gefunden wird. Es 
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werden höchstens ein führendes Vorzeichen und fünf Ziffern benutzt. Bei 
Werten über 32767 gibt Dtoif ) ERR zurück. 


otoi(str, nbr) char *str; int *nbr; 


Diese Small-C-Funktion wandelt eine oktale Zahl in der Zeichenkette str 
in eine Integer nbr um und gibt die Länge des gefundenen oktalen Feldes 
zurück. Wenn eine nicht-oktale Ziffer in str gefunden wird, wird gestoppt. 
Beim Arbeiten mit 16-Bit-Integern werden höchstens ein führendes Vor- 
zeichen und fünf Ziffern benutzt. Bei einer oktalen Ziffer größer als 
177777 gibt atoi( ) ERR zurück. 


utoi(str, nbr) char *str; int *nbr; 


Diese Small-C-Funktion wandelt eine dezimale Zahl ohne Vorzeichen, dar- 
gestellt durch die Zeichenkette str, in eine Integer ndr um und gibt die 
Länge des gefundenen numerischen Feldes zurück. Gestoppt wird, wenn 
das Ende der Zeichenkette erreicht wird oder wenn ein nicht dezimales 
Zeichen gefunden wird. Beim Arbeiten mit 16-Bit-Integern werden höch- 
stens ein führendes Vorzeichen und fünf Ziffern benutzt. Bei einer Zahl 
größer als 65535 gibt utoi( ) ERR zurück. 


xtoi(str, nbr) char *str; int *nbr; 


Diese Small-C-Funktion wandelt eine hexadezimale Zahl in der Zeichen- 
kette str in ein Integer nbr um und gibt die Länge des gefundenen hexa- 
dezimalen Feldes zurück. Gestoppt wird, wenn das Ende der Zeichenkette 
erreicht wird oder wenn ein nicht-hexadezimales Zeichen gefunden wird. 
Beim Arbeiten mit 16-Bit-Integern werden höchstens eın führendes Vor- 
zeichen und fünf Ziffern benutzt. Wenn mehr Ziffern vorhanden sind, gibt 
xtoi( ) ERR zurück. 


itod(nbr, str, sz) int nbr, sz; char str; 


Diese Small-C-Funktion wandelt nbr ın eine Zahl mit Vorzeichen (wenn 
negativ) in str um. Das Ergebnis erscheint rechtsbündig und mit Leer- 
zeichen gefüllt ın str. Das Vorzeichen und mögliche höherwertige Ziffern 
werden abgeschnitten, wenn die Zielzeichenkette zu klein ist. Zurückgege- 
ben wird str. Sz zeigt dıe Länge der Zeichenkette an. Wenn sz größer Null 
ist, erscheint ein Null-Byte bei s/r/sz-1]. Wenn sz Null ist, zeigt eine 
Suche nach dem ersten str folgenden Null-Byte das Ende der Zeichenkette 
an. Wenn sz kleiner Null ist, werden alle sz Zeichen von str benutzt, ein- 
schließlich dem letzten. 
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itoo(nbr, str, sz) int nbr, sz; char *#str; 


Diese Small-C-Funktion wandelt nbr ın eine oktale Zeichenkette ın str um. 
Das Ergebnis erscheint rechtsbündig und mit Leerzeichen gefüllt in der 
Zielzeichenkette. Höherwertige Ziffern werden abgeschnitten, wenn die 
Zielzeichenkette zu klein ist. Zurückgegeben wird str. Sz zeigt die Länge 
der Zeichenkette an. Wenn sz größer Null ist, erscheint ein Null-Byte bei 
str[sz-1]. Wenn sz Null ist, zeigt eine Suche nach dem ersten str folgenden 
Null-Byte das Ende der Zeichenkette an. Wenn sz kleiner Null ist, werden 
alle sz Zeichen von sfr benutzt, einschließlich dem letzten. 


itou(nbr, str, sz) int nbr, sz; char *#str; 


Diese Small-C-Funktion wandelt ndbr in eine dezimale Zeichenkette ohne 
Vorzeichen in str um. Sıe arbeitet ähnlich itod( ), nur daß das höherwertige 
Bit von nbr als Vorzeichenbit angesehen wird. 


itox(nbr, str, sz) int nbr, sz; char *#str; 


Diese Small-C-Funktion wandelt nbr ın eine hexdezimale Zeichenkette in 
str um. Das Ergebnis erscheint rechtsbündig und mit Leerzeichen gefüllt in 
der Zielzeichenkette. Höherwertige Ziffern werden abgeschnitten, wenn die 
Zielzeichenkette zu klein ist. Zurückgegeben wird str. Sz zeigt die Länge 
der Zeichenkette an. Wenn sz größer Null ist, erscheint ein Null-Byte beı 
str[sz-1]. Wenn sz Null ıst, zeigt eine Suche nach dem ersten sir folgenden 
Null-Byte das Ende der Zeichenkette an. Wenn sz kleiner Null ıst, werden 
alle sz Zeichen von str benutzt, einschließlich dem letzten. 


Funktionen für die Zeichenkettenbehandlung 
left(str) char *str; 


Diese Small-C-Funktion richtet eine Zeichenkette in str linksbündig aus. 
Beginnend mit dem ersten nicht-leeren Zeichen und fortfahrend bis zum 
Null-Byte am Schluß wird die Zeichenkette an die durch str angegebene 
Adresse gebracht. 


pad(str, ch, n) char *#str, ch; int n; 


Diese Small-C Funktion füllt die Zeichenkette beı str n-Mal mit dem Zei- 
chen cha. 


reverse(str) char *str; 


Diese Funktion kehrt die Reihenfolge der Zeichen ın der mit Null abge- 
schlossenen Zeichenkette ın str um. 
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strcat(dest, sour) char *dest, *sour; 


Diese Funktion fügt die Zeichenkette ın sour ans Ende der Zeichenkette 
dest an. Das Null-Zeichen am Ende von dest wird durch das erste Zeichen 
von sour ersetzt. Ein Null-Zeichen beendet die neue dest-Zeichenkette. Der 
für dest reservierte Platz muß groß genug sein, um das Ergebnis aufneh- 
men zu können. Diese Funktion gibt des! zurück. 


strncat(dest, sour, n) char *dest, *sour; int n; 


Diese Funktion arbeitet ähnlich strcat(), nur das maxımal n Zeichen von 
der Quellzeichenkette zur Zielzeichenkette übertragen werden. 


strcmp(strl, str2) char *strl, *str2; 


Diese Funktion gibt eine Integer kleiner als, gleich oder größer als Null 
zurück, abhängig davon, ob die Zeichenkette sir/ kleiner als, gleich oder 
größer als die Zeichenkette sir2 ıst. Die Zeichen werden einzeln mitein- 
ander verglichen, beginnend am linken Ende der Zeichenketten bis ein 
Unterschied gefunden wird. Der Vergleich basıert auf dem numerischen 
Wert der Zeichen. Str2 hat eine geringere Wertigkeit als str/, wenn str2 
gleich aber kürzer als str] ıst und umgekehrt. 


lexcmp(strl, str2) char *strl, *str2; 


Diese Small-C-Funktion arbeitet wie strcmp( ), nur das ein lexikografischer 
Vergleich benutzt wird. Damit die Ergebnisse sinnvoll sind, sollten nur 
ASCIH-Zeichen (0-127 dezimal) ın den Zeichenketten erscheinen. Buch- 
staben werden in Wörterbuchreihenfolge verglichen, wobei Großbuchstaben 
gleich den Kleinbuchstaben sind. Sonderzeichen gehen den Buchstaben vor- 
aus, wobei den Sonderzeichen wiederum dıe Kontrollzeichen vorausgehen, 
mit Ausnahme von DEL, das den höchsten Wert hat. 


strncmp(strl, str2, n) char *strl, *str2; int n; 


Diese Funktion arbeitet ähnlich szrcemp( ), nur das maximal n Zeichen ver- 
glichen werden. 


strcpy(dest, sour) char *dest, *sour; 


Diese Funktion kopiert die Zeichenkette bei sour nach dest. Dest wırd 
zurückgegeben. Dest muß für das Ergebnis groß genug sein. 


strncpy (dest, sour, n) char *dest, *sour; int n; 


Diese Funktion arbeitet wie sircpy(), nur daß n Zeichen in die Ziel- 
zeichenkette gebracht werden, gleichgültig wie lang die Quellzeichenkette 
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ist. Wenn die Quellzeichenkette zu kurz ist, wird mit Nullen aufgefüllt. 
Wenn sie zu lang ist, wird sie bei dest abgeschnitten. Ein Null-Zeichen 
folgt dem letzten in die Zielzeichenkette gebrachten Zeichen. 


strlen(str) char *str; 


Diese Funktion gibt die Anzahl der Zeichen in der Zeichenkette sir zurück. 
Das Null-Zeichen am Ende der Zeichenkette wird nıcht gezählt. 


strchr (str, c) char *#str, c; 


Diese Funktion gibt einen Zeiger auf das erste Vorkommen des Zeichens c 
in der Zeichenkette str zurück. Sie gibt NULL zurück, wenn das Zeichen 
nicht gefunden wird. Die Suche wird mit dem ersten Null-Zeichen beendet. 


strrchr (str, c) char *str, c; 


Diese Funktion arbeitet wie strchr(), nur daß das am weitesten rechts ste- 
hende Vorkommen des Zeichens gesucht wird. 


Funktionen für die Zeichenklassifizierung 


Die folgenden Funktionen entscheiden, ob ein Zeichen zu einer bestimmten 
Zeichenklasse gehört. Sıe geben bei Übereinstimmung "true" (nicht Null) 
zurück und "false" (null) bei keiner Übereinstimmung. 


isalnum(c) char c; 

Diese Funktion stellt fest, ob c alphanumerisch (A-Z, a-z, oder 0-9) ist. 
isalpha(c) char c; 

Diese Funktion stellt fest, ob c ein Buchstabe (A-Z oder a-z) ist. 
isascii(c) char c; 


Diese Funktion stellt fest, ob c ein ASCII-Zeichen (dezimale Werte 0-127) 
1st. 


iscentrl(c) char c; 


Diese Funktion stellt fest, ob c ein Kontrollzeichen (ASCII-Code 0-31 oder 
127) ıst. 


isdigit(c) char c; 


Diese Funktion stellt fest, ob c eine Ziffer (0-9) ist. 
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isgraph(c) char c; 


Diese Funktion stellt fest, ob c ein grafisches Symbol (ASCII-Codes 33- 
126) ıst. 


islower(c) char c; 

Diese Funktion stellt fest, ob c ein Kleinbuchstabe (ASCII-Codes 97-122) 
ist. 

isprint(c) char c; 


Diese Funktion stellt fest, ob c ein druckbares Zeichen (ASCII-Codes 32- 
126) ıst. Leerzeichen werden als druckbar betrachtet. 


ispunct (c) char c; 


Diese Funktion stellt fest, ob c ein Interpunktionszeichen (alle ASCII-Codes 
außer Kontrollzeichen und alphanumerische Zeichen) ist. 


isspace(c) char c; 


Diese Funktion stellt fest, ob c ein Leerstellenzeichen (ASCII SP, HT, VT, 
CR, LF oder FF) ist. 


isupper(c) char c; 
Diese Funktion stellt fest, ob c ein Großbuchstabe ist (ASCII-Codes 65-90). 
isxdigit(c) char c; 


Diese Funktion stellt fest, ob c ein hexadezimales Zeichen ist (0-9, A-F 
oder a-f). 


lexorder (cl, c2) char cl, c2; 


Diese Small-C-Funktion gibt eine Integer kleiner als, gleich oder größer als 
Null zurück, abhängig davon, ob c/ lexıkographisch kleiner als, gleich oder 
größer als c2 ist. Damit die Ergebnisse sinnvoll sind, sollten nur ASCII- 
Zeichen (0-127 dezimal) übergeben werden. Buchstaben werden in Wörter- 
buchreihenfolge verglichen, wobei Großbuchstaben gleich den Kleinbuch- 
staben sind. Sonderzeichen gehen den Buchstaben voraus, wobei den Son- 
derzeichen wiederum die Kontrollzeichen vorausgehen, mit Ausnahme von 
DEL, das den höchsten Wert hat. 
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Funktionen für die Zeichenumwandlung 
toascii(c) char c; 


Diese Funktion gibt das ASCII-Äquivalent von c zurück. Bei Systemen, die 
den ASCII-Zeichensatz benutzen, wird c einfach unverändert zurückgege- 
ben. Diese Funktion ermöglicht es die Eigenheiten des ASCII-Codes zu be- 
nutzen ohne Implementationsabhängigkeiten in ein Programm zu bringen. 


tolower(c) char c; 


Diese Funktion gibt den Kleinbuchstaben c zurück, wenn c ein Großbuch- 
stabe ist; sonst wird c unverändert zurückgegeben. 


toupper(c) char c; 
Diese Funktion gıbt den Großbuchstaben c zurück, wenn c ein Kleinbuch- 


stabe ist; sonst wird c unverändert zurückgegeben. 


Mathematische Funktionen 

abs(nbr) int nbr; 

Diese Funktion gibt den Absolutwert von nbr zurück. 

sign(nbr) int nbr; 

Diese Funktion gibt -1, O0 oder +1 zurück, abhängig davon ob nbr kleiner 
als, gleich oder größer als Null ıst. 

Funktionen für die Programmkontrolle 


calloc(nbr, sz) int nbr, sz; 


Diese Funktion ordnet nbr*sz Bytes auf Null gesetzten Speicher zu. Bei Er- 
folg wird die Adresse des Speicherblocks zurückgegeben, sonst Null. 


malloc(nbr) int nbr; 


Diese Funktion ordnet nbr Bytes uninitialisierten Speicher zu. Bei Erfolg 
wird dıe Adresse des Speicherblocks zurückgegeben, sonst Null. 


avail(abort) int akbort; 


Diese Small-C-Funktion gibt den freien Speicherplatz zwischen dem Pro- 
gramm und dem Stapel zurück. Geprüft wird auch, ob sich der Stapel mit 
dem zugeordneten Speicher überlappt; wenn ja und wenn abort nicht Null 
ist, wird das Programm abgebrochen und auf dem Bildschirm erscheint der 
Buchstabe S, der einen Stapelfehler anzeigt. Wenn jedoch abort Null ist, 
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gibt avail() Nullan den Aufrufer zurück. Durch diese Funktion kann man 
den vollen Speicherplatz ausnutzen. Man sollt jedoch darauf achten, daß 
für die Benutzung des Stapels genug Platz bleibt. 


free(addr) char *addr; (alias cfree) 


Diese Funktion gibt ab Adresse addr einen Block zugeordneten Speichers 
frei. Bei Erfolg wird addr zurückgegeben, sonst NULL. Es ist notwendig 
den Speicher in umgekehrter Reihenfolge wieder freizugeben wie er zuge- 
ordnet worden war. Man sollte vermeiden Speicher freizugeben bevor eine 
Dateı geöffnet wurde, da die open-Funktion dynamisch Puffer und FCB- 
Platz zuordnet. Man darf nıcht davon ausgehen, daß durch Schließen eıner 
Datei ihr Speicher freigegeben wird 


getarg(nbr,str,sz,argc,argv) 
char *str; int nbr, sz, argc, *argv; 


Diese Small-C-Funktion findet das Argument aus der Befehlszeile, das 
durch ndbr angegeben wird, bringt es (mit Null abgeschlossen) in die Zei- 
chenkette str mit maximaler Länge sz und gibt die Länge des erhaltenen 
Feldes zurück. Argc und argv müssen für die Funktion main( ) die gleichen 
Werte zur Verfügung stellen, wenn das Programm gestartet wird. Wenn nbr 
Null ıst, ıst der Programmname gewünscht. Wenn nbr 1 ist, ist das erste 
Argument nach dem Programmnamen erwünscht und so weiter. CP/M gibt 
den Programmnamen an ein Programm nicht weiter, daher wird an diese 
Stelle ein Stern gesetzt. Wenn kein Argument nbr entspricht, bringt get- 
arg() ein Nullbyte nach si/r und gibt EOF zurück. 


poll(pause) int pause; 


Diese Small-C-Funktion fragt die Tastatur nach einer Eingabe des Benutzer 
ab. Wenn keine Eingabe ansteht, wird Null zurückgegeben. Wenn ein Zei- 
chen wartet, bestimmt der Wert von value, was geschieht. Wenn pause Null 
ist, wird das Zeichen sofort zurückgegeben. Wenn pause nicht Null ist und 
das Zeichen ein Control-S ist, gibt es eine Pause in der Programmausfüh- 
rung; wenn das nächste Zeichen über die Tastatur eingegeben wird, wird 
Null an den Aufrufer übergeben. Wenn das Zeichen Control-C ıst, wird die 
Programmausführung beendet. Alle anderen Zeichen werden sofort an den 
Aufrufer zurückgegeben. 


exit(errcode) int errcode; (alias abort) 


Diese Funktion schließt alle offenen Dateien und springt ins Betriebssystem 
zurück. Wenn errcode ungleich Null ist, wird der Code zum Bildschirm ge- 
schrieben; ein Programm, das mit der Anweisung exit(7) (Code 7 = Con- 
trol-G, Pıiepser) endet, läßt den Lautsprecher ertönen. 
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4 Das Small-Mac-Assemblerpaket 


Small-Mac ıst ein Makro-Assembler für 8080-/Z80-Systeme unter CP/M. 
der für den Small-C-Compiler entwickelt wurde. Als solcher soll er die 
Small-C-Benutzer durch seine betonte Einfachheit, Portabilität, Adaptier- 
barkeit und seinen Lehreffekt ansprechen. Diesen primären Zielen wurden 
Programmgröße und Ausführungszeit untergeordnet. Daher wurde Small- 
Mac, genau wie der Small-C-Compiler, in Small-C geschrieben und wird 
im Quellcode und Objektcode geliefert. Die hervorstechendsten Eigenschaf- 
ten des Small-Mac-Pakets sınd: 


einfach zu handhaben 

Makro-Möglichkeiten 

Operatoren für Ausdrücke aus der C-Sprache 
anschauliche Fehlermeldungen 

extern definierte Maschineninstruktionstabelle 


00000 


Folgende Programme sınd im Small-Mac-Paket enthalten: 


MAC Makroassembler 

LNK Linker 

LGO Lader (laden-und-ausführen, load and go) 
LIB Bibliotheksverwalter 

CMIT CPU-Anpassungsprogramm 

DREL Dump relokatierbarer Objektdateien 


MAC ıst ein tabellengesteuerter Makroassembler mit zwei Läufen, der ver- 
schiebbaren (relokatierbaren) Code erzeugt. Er lernt die Zielmaschine aus 
einer Maschineninstruktionstabelle (MIT), die mit einem Texteditor erzeugt 
und mit der Anpassungsutility CMIT kompiliert wird. Small-Mac erzeugt 
relokatierbare Objektmodule im 8-Bit-Microsoft-Format und wird durch 
eine einfache Befehlssyntax aufgerufen. 


LNK ist der Linker für Small-Mac. Er kombiniert Objektmodule mit 
Modulen aus einer Bibliothek zu einem vollständigen, ausführbaren Pro- 
gramm. Die Standardausgabe ist eine COM-Dateı. Er kann eine Laden- 
und-Ausführen Datei (LGO, load-and-go) für die Ausführung an einer ge- 
wünschten Adresse erzeugen. 


LGO lädt und führt wahlweise LGO-Dateien aus. Er ist äußerst nützlich, 
um Systemerweiterungen nach dem Booten des Betriebssystem zu laden. 
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LIB erstellt, wartet und listet den Inhalt von LNK-kompatiblen Biblio- 
theken. Dadurch kann man Module assemblieren, die verschiedenen Pro- 
grammen gemeinsam Sind, sie in einer einzigen Bibliothek zusammenfassen 
und dann LNK die Bibliothek nach den Modulen suchen lassen, die von 
dem Programm gebraucht werden, das gelinkt werden soll. 


CMIT kompiliert Tabellen für Maschineninstruktionen, listet sie und konfi- 
guriert den Assembler wahlweise mit der sich ergebenden Objekttabelle. 
Dieser Definitionsansatz für die Assemblermaschineninstruktion ist sehr 
flexibel, und erlaubt es, den Assembler an verschiedene CPUs anzupassen 
und spezielle Maschineninstruktionen ohne den gesamten Überbau der 
Makroverarbeitung anzulegen. 


DREL erzeugt eine formatierte Hex-Ausgabe (Dump) von REL- und LIB- 
Dateien. So kann man den Inhalt dieser Dateien zu studieren, obwohl sie 
auf Bitebene strukturiert sind. 


Systemanforderungen 


Diese Implementation des Small-Mac-Paketes läuft auf 8080-/8085-/Z80- 
Systemen, die das CP/M-Betriebssystem verwenden. Man sollte ein Dis-. 
kettenlaufwerk und mindestens 56 KByte Speicher haben. 


Quelldateien 


Quellzeilen haben ein freies Format, mit Feldern, die in der Zeile in der 
folgenden Reihenfolge erscheinen: 


Symbol/Label Operation Operand Kommentar 


Jedes Feld ist optional und Leerzeilen werden ignoriert. Felder werden 
durch Leerstellen (Leerzeichen und Tabs) getrennt; Kommentaren geht ein 
Semikolon voraus (;). 


Das Feld Symbol/Label 


Eın Symbol besteht aus einer zusammenhängenden Sequenz von Buchsta- 
ben, Ziffern und aus den Sonderzeichen _.$ ? oder @. Das erste Zeichen 
darf keine Ziffer sein. Klein- und Großbuchstaben sind gleichbedeutend. 
Symbole können beliebig lang sein, aber nur die ersten 8 Zeichen sind 
signifikant und nur sechs Zeichen werden für die Deklaration externer 
Referenzen und Einsprungspunkte in Objektmodulen benutzt. Label im 
Symbol/Label-Feld werden ımmer mit einem Doppelpunkt abgeschlossen 
(:). Sie können allein oder gefolgt von einer Anweisung und/oder einem 
Kommentar erscheinen. Die Adresse, die dem Label zugewiesen wird, ist 
die Adresse des ersten Bytes der nächsten Instruktion oder Datenbereichs. 
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Zwei Doppelpunkte, die einem Label folgen, definieren es als Einsprungs- 
punkt. Verweise auf Label und Symbole dürfen nicht durch Doppelpunkt 
beendet werden. 


Das Operationsfeld 


Wenn dem Operationscode (Opcode) oder den Assembleranweisungen 
(Pseudo-Op) keine Label oder Symbole vorausgehen, kann das ÖOperations- 
feld ın der ersten Zeichenstelle beginnen. Die Assembleranweisungen wer- 
den innerhalb des Assemblers definiert, die Opcodes, die Maschinenin- 
struktionen, werden jedoch in einer externen Maschineninstruktionstabelle 
definiert, die durch das Anpassungsprogramm CMIT in das interne Format 
kompiliert und in den Assembler gebracht wird. 


Das Operandenfeld 


Operanden und/oder Operandenstellen (Speicherstellen oder Registernamen) 
werden ım Operandenfeld angegeben. 


Symbole im Operandenfeld müssen entweder irgendwo ın der Dateı defi- 
niert oder als extern deklariert werden. Dies erreicht man, indem man sie 
entweder mit zwei ##-Zeichen abschließt oder indem man die Anweisung 
EXT benutzt. 


Das Dollarzeichen ($) kann im Operandenfeld als Label für die aktuelle 
Adresse der Anweisung benutzt werden. 


Speicherverweise und numerische Werte können als Ausdrücke geschrieben 
werden. Die Operatoren in Small-Mac-Ausdrücken sind ein Subset von 
denen der C-Sprache und folgen den gleichen Vorrang- und Anordnungs- 
regeln. Damit braucht der C-/Assembler-Programmier nur einmal die 
Regeln zu lernen. Mehr über Ausdrücke erscheint unten ım Abschnitt 
"Ausdrücke". 


Kommentare 


Kommentare können als letztes Feld ın einer Zeile erscheinen. Ein Semi- 
kolon zeigt den Beginn von Kommentaren an. Eine Zeile kann vollständig 
aus einem Kommentar bestehen, wenn das Semikolon als erstes Zeichen an- 
gegeben wird. Leerzeichen vor Kommentaren sind nicht nötig. 


Objektdateien 


Small-Mac kennt zwei Arten von OÖbjektdateien: Module und Bibliotheken. 
Module werden durch den Assembler angelegt und haben immer die Datei- 
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namenserweiterung REL. Bibliotheken werden durch den Bibliotheksmana- 
ger erzeugt und bestehen aus einem Dateipaar: der Bibliothek selbst 
(Erweiterung LIB) und einem Index für die Bibliothek (Erweiterung NDX) 


Die Small-Mac-Objektmoule sind verschiebbar und folgen dem 8-Bit- 
Microsoft-Format. Dies ist ein Bitfeldformat, um die Größe von Objekt- 
dateien zu reduzieren. Es gibt keine Byteausrichtung, außer am Beginn 
eines Moduls. Die Bitfelder sınd in der folgenden Tabelle aufgeführt: 


LINK FORMAT 
0 <8-Bits> 


1000000 
1000001 
1000010 
1000011 
1000100 
1000101 
1000110 
1000111 
1001000 
1001001 
1001010 
1001011 
1001100 


En 


L 
L 
L 
l 
L 


< 
< 
< 
< 
< 
< 
< 
< 
< 
< 


<Zeiket> 
<Zeiket> 
<Zeiket> 
<Zeiket> 
<Zeiket> 
16-Bits> ILL <Zeiket> 
16-Bits> Lil <Zeiket> 
16-Bits> Lll <Zeiket> 
16-Bits> 
16-Bits> 
16-Bits> 
16-Bits> 
16-Bits> 
16-Bits> 
16-Bits> 


<16-Bits> 
<16-Bits> 


100 
100 
101 <16-Bits> 
110 
111 


BESCHREIBUNG 

Absolutes Feld 
Eingangssymbol 

allg. Block wählen 
Programmname 

zu durchsuch. Bibliothek 
erweitertes Link-Feld 
allg. Bereichsgröße 
externe Verweiskette 
Einsprungspunkt 
externen Verweis dekre. 
externen Verweis inkre. 
Datenbereichsgröße 
Positionszähler setzen 
Positionszählerkette 
Programmbereichsgröße 
Modulende 

Dateiende 
Programmrelatives Feld 
Datenrelatives Feld 


BENUTZT? 


JA 
NEIN 


Allgemein relatives Feld NEIN 


Das Feld ll belegt 3 Bits und gibt die Zeichenkettenlänge an. Das Feld tt 
belegt 2 Bits und gibt den Typ des folgenden 16-Bit Feldes an. Die Typ- 
codes sind: 


co 


DE BEDEUTUNG 


absolut 
programmrelativ 
datenrelativ 
allgemein relativ 


BENUTZT? 


JA 
JA 
NEIN 
NEIN 
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Die Reihenfolge in einem Modul lautet: 


. Programmname 
. Eingangssymbole (ungeordnet) 
. Programmbereichsgröße 
. Eigentliches Modul 
absoluter Teil 
programmirelativer Teil 
externe Referenz Inkrement 
Teile für den Positionszähler setzen 
5. Liste (in alphanumerischer Reihenfolge) von 
externen Referenzketten 
Eınsprungspunkten 
6. Programmende 
7. Dateiende 


DR WW D 


Eine Bibliothek ıst eine Verkettung von Modulen, mit dem einen Unter- 
schied, daß es nur eine Dateiendekennung gibt. Ein Bibliotheksindex sind 
bloße Wortpaare, die auf den Anfang eines jeden Moduls in der Bibliothek 
zeigen. Das erste Wort gibt den 128-Byte-Block an, das zweite das Byte ım 
Block. Beide beginnen bei Null. 


Programmrelative Felder können Adressen, Daten und Zeiger auf Ketten 
sein. Das Ende einer Kette wird durch ein absolutes Feld mit dem Wert 
Null angezeigt. Alle externen Referenzen zu einem Einsprungspunkt sind 
mit der Adresse des entsprechenden Einsprungspunktes verkettet, so daß 
der Linker sıe finden unsd ersetzen (auflösen) kann. Wenn eine externe 
Referenz ın eine Anweisung eingeschlossen ist, so daß das Ergebnis ein 
Offset (negativ oder positiv) von der Referenz ıst, dann geht der Kette 
unmittelbar ein externes Referenzinkrement voraus. Dieser wird nach der 
Auflösung dazu addiert. Das Inkrementfeld hat keinen Effekt auf den zu 
ladenden Positionszähler. Small-Mac-Assemblerlistings zeigen sowohl den 
Zeiger auf die Kette als auch den Inkrementwert. 


Maschineninstruktionen 


Wie oben schon erwähnt, werden Maschineninstruktionen in einer externen 
Maschineninstruktionstabelle definiert (MIT). Dies ist eine ASCII-Datei, ın 
der die Operationmnemoniks, die Syntax der Operanden und der Objekt- 
code für jede Maschineninstruktion enthalten ist. Das Anpassungsprogramm 
CMIT kompiliert diese Tabelle ın internes Format, listet sie dann wahlweise 
und/oder fügt eine Kopie in den Assembler ein. 


Dieser Ansatz der Definition der Maschineninstruktionstabelle macht es 
sehr viel einfacher, den Assembler auch an andere CPUs adaptieren. Weiter 
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wird dadurch auch das Anlegen besonderer Instruktionssätze vereinfacht, 
die sofort assembliert werden können, ohne den Aufwand für eine Makro- 
verarbeitung. 


In Anhang D sınd die Maschineninstruktionstabellen für die 8080- und die 
Z80-Prozessoren abgedruckt. Jede Zeile besteht aus drei Feldern: Objekt, 
Menmonic und Operand. Leerstellen trennen die Felder. 


Ausdrucksbeschreiber können in den Operand- und Objektfelder erschei- 
nen. Sie zeigen an, wo in der Operandensystax eine Ausdruck erscheinen 
kann und wo dann ım Objektcode der entsprechende Ausdruckswert zu 
stehen hat. Ebenso wird auch die Größe des Objektwertes angegeben (ein 
oder zwei Byte) und ob dies ein zum Programmzähler (PC) relativer Wert 
ist oder nicht. Ausdrucksbeschreiber bestehen aus den Kleinbuchstaben x 
oder p und (im Objektfeld) einer Ziffer, die die Anzahl der Bytes angibt 
(ein oder zwei). Der Buchstabe x kennzeichnet einen normalen Ausdrucks- 
wert und der Buchstabe p einen PC-relativen Wert. Außer für diese Be- 
schreibungen müssen alle anderen Bezeichnungen in Großbuchstaben er- 
scheinen. 


In der kompilierten MIT werden 16 Bits benutzt, um das Format des 
Objektcodes zu beschreiben. Jedes Codebyte benutzt ein Bit im Formatwort 
und jeder Ausdruck benutzt drei Bits. Daher kann jede Kombination von 
Bytes und Ausdrücken erzeugt werden, solange die Zahl der benutzten 
Formatbits 16 nicht übersteigt. 


Zwischen den Objektkomponenten werden Unterstriche für die bessere 
Lesbarkeit verwendet. Die Codebytes und die Ausdruckswerte werden in 
der ım Objektfeld angegeben Reihenfolge erzeugt. Wenn mehr als ein Aus- 
druck angegeben wird, stellt sie der Assembler genau in der Reihenfolge in 
die Objektdatei, wie sie im Operandenfeld erscheinen. 


Damit eine Instruktion mit einer Eintragung in der MIT übereinstimmt, 
führt der Assembler für ein Mnemonik eine Hashsuche durch und dann 
eine serielle Suche für die korrekte Operandenvariante. Die serielle Suche 
verläuft in der Reihenfolge der Varianten im MIT. Dies geht gut bei 8080- 
Assemblermnemoniks aber ziemlich schlecht beim Z80, der für einige 
Mnemoniks eine ganze Menge Varianten hat (zum Beispiel LD). Wenn man 
etwas über die relative Häufigkeit der benutzten Operandenvarianten weiß, 
kann man die Reihenfolge in der MI-Tabelle ändern, um Suchzeit zu spa- 
ren. Alle Varianten eines gegebenen Mnemoniks müssen jedoch zusammen- 
bleiben. 


Durch die Benutzung von senkrechten Strichen im Operandenfeld der MIT 
kann man Platz sparen, wegen der Redundanz der Operandenvarianten ın 
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den meisten Instruktionssätzen und der Tendenz der CP/M-Architekten, 
Objektcodes sequentiell zuzuordnen. Durch den senkrechten Strich werden 
die Varianten auf der gleichen Zeile voneinander getrennt. In solchen Fäl- 
len wird das Objektbyte, das dem ersten Operanden unmittelbar vorausgeht 
oder zuletzt kommt, wenn es keinen Ausdruck gibt, auf die erste Varıante 
angewendet. Für jede folgende Variante auf der gleichen Zeile wird dieses 
Byte um eins erhöht. Die anderen Objektbytes bleiben unverändert. 


Wenn man plant, die MIT zu ändern, ıst es von äußerster Wichtigkeit, daß 
man verstanden hat, wie der Assembler die Übereinstimmung zwischen ei- 
nem Ausdruck und einem Ausdrucksbeschreiber aus dem Operandenfeld im 
MIT findet. Für ein besseres Verständnis sollte man sich die Datei MIT.C 
ansehen. Wenn einmal das Instruktionsmnemonik im MIT gefunden wurde, 
wird match( ) aufgerufen, um zu versuchen eine Übereinstimmung mit der 
Operandenvariante zu finden. Sie vergleicht Zeichen von links nach rechts, 
wobei Groß- und Kleinbuchstaben gleich behandelt werden. Wenn keine 
Übereinstimmung gefunden wird, scheitert diese Variante; bei Erfolg wird 
das nächste Zeichenpaar verglichen. Wenn im MIT-Operandenfeld ein p 
oder x gefunden wird, wird die Zeichenkette, die mit dem aktuellen In- 
struktionszeichen beginnt, ausgelassen, bis ein Komma oder eine unpaarige 
rechte Klammer erscheint. Unpaarig heißt in diesem Fall, nicht gefunden 
während des Überlesens der Ausdruckzeichenkette. 


Wenn zum Beispiel die Instruktion "LD A,((a+b)/2)" als übereinstimmend 
mit "LD A,(x)" gefunden wird, dann beendet die zweite rechte Klammer 
das Überlesen der Ausdrücke, weil nur die erste Klammer im Überlese- 
prozeß gefunden wird. Also wırd die Zeichenkette "(a+b)/2" als Ausdruck 
interpretiert. Dieser Teil der Instruktion wird aus der Quellzeile während 
des Suchverfahrens herausgelöst und in einen separaten Puffer gebracht, 
zur weiteren Analyse. 


Was würde nun passieren, wenn die Anweisung "LD A,(x)" im MIT vor 
"LD A,(HL)" erscheinen würde, während die Instruktion "LD A,(HL)" ge- 
rade assembliert würde? Richtig, HL würde als Ausdruck interpretiert und 
die Instruktion würde irrtümlichweise als "LD A,(x)" gefunden werden. Da- 
her sollte man vorsichtig sein, wenn solche Varianten nach anderen Vari- 
anten kommen, die übereinstimmen könnten. Übrigens würde dieser Fehler 
ohne Zweifel eine Assemblerfehlermeldung produzieren. 


Assembleranweisungen 


Small-Mac unterstützt die Assembleranweisungen (Pseudo-Ops) in der fol- 
genden Tabelle. Diese Small-Mac-Version sieht keine wiederholten 
Assembleranweisungen oder bedingte Assemblierung vor. 
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SYNTAX FUNKTION 
[Label] DW Wert[,Wert[,...]] definiert Worte 
[Label] DB Wert[,Wert[,...]] definiert Bytes 
[Label] DS Ausdruck reserviert Speicher 
(Label) EXT Symbol [,Symboll,...)] deklariert externe Referenzen 
Symbol SET Ausdruc setzt Symbol auf den Wert von Ausdruck 
Symbol EQU Ausdruck Symbol ıst gleich Ausdruck 
[Label] ORG Ausdruck Positionszähler auf Ausdruck setzen 
[Label] END [Ausdruck] Ende der Quelldatei 
(Ausdruck gibt die Startadresse an) 

Symbol MACRO Beginn einer Makrodefinition 

ENDM Ende einer Makrodefinition 


[Label] Makroname [par[,parl,...]]] Aufrufen (erweitern) des benannten Makros 


Bei den Pseudo-Ops aus Tabelle 2 zeigen eckige Klammern optionale Ele- 
mente an. Der Term Wert steht entweder für einen Ausdruck oder eine 
Zeichenkette. Zeichenketten werden ın Anführungszeichen (") oder Hoch- 
kammas (’) eingeschlossen. Wenn diese Zeichen auch innerhalb der Zei- 
chenkette erscheinen sollen, müssen zwei aufeinanderfolgende Zeichen 
erscheinen. Der Term Ausdruck steht für einen Ausdruck. 


[Label] DW Wert[,Wert[,...]] 


Definiert Worte: Für jeden Wert im Operandenfeld reserviert der Assembler 
ein Wort, das den Wert enthält. Wenn ein Label angegeben ist, wird die 
Adresse des ersten Wortes angenommen. 


[Label] DB Wert[ ,‚Wert[,...]] 


Definiert Bytes: Für jeden Wert ım Operandenfeld reserviert der Assembler 
ein Byte, das den Wert enthält. Jeder Wert muß absolut sein. Wenn ein La- 
bel angegeben ist, wird die Adresse des ersten Bytes angenommen. 


[Label] DS Ausdruck 


Reserviert Speicherplatz: Die Anzahl der im Ausdruck angegeben Bytes 
wird reserviert. Sie haben keinen vorhersagbaren Wert. Der Ausdruck muß 
einen absoluten Wert ergeben. Wenn ein Label angegeben ist, wird die 
Adresse des ersten Bytes angenommen. 


[Label] EXT Symbol[,Symbol[(,...]] 


Deklariert externe Referenzen: Jedes angegebene Symbol wird als extern 
deklariert. Wenn ein Label angegeben ist, wird die Adresse der nächsten 
Anweisung oder des nächsten Datenbytes im Programm angenommen. Ein 
Symbol als extern zu deklarieren ist ausreichend, damit das Modul, daß es 
als Einsprungspunkt enthält, durch den Linker zu dem Programm geladen 
wird. Es muß nicht ausdrücklich darauf Bezug genommen werden. 
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Symbol SET Ausdruck 


Symbolwert setzen: Dieser Pseudo-Befehl setzt das Symbol auf den Wert des 
Audrucks. Es kann später durch andere SETs zurückgesetzt werden. Wenn 
einem Symbol einmal ein Wert zugewiesen wurde, kann es in Ausdrücken 
benutzt werden. 


symbol EQU expr 


Symbol einem Wert gleichsetzen: Dieser Pseudo-Befehl weist einem Symbol 
den Wert eines Ausdrucks zu. Dasselbe Symbol kann nicht mehr mit SET 
oder EQU gesetzt werden. Wenn einmal der Wert einem Symbol zugewiesen 
wurde, kann er ın Ausdrücken benutzt werden. 


[label] ORG Ausdruck 


Anfangswert für Programmzähler einstellen: Dieser Pseudo-Befehl stellt den 
Wert des Programmzählers eın. In Small-Mac kann der Zähler nur vorwärts 
bewegt werden. Das hindert Programmierer daran, alten mit neuem Code 
zu überschreiben und schützt den Linker vor Irrtümern, wenn er versucht, 
externe Referenzketten aufzulösen. 


[label] END [Ausdruck] 


Ende der Quelldatei: Dieser Pseudo-Befehl bestimmt das Ende der Quell- 
datei. Er ist erforderlich und muß die letzte Zeile im Programm seın. Wenn 
ein Label vorhanden ist, wird die programmrelative Adresse des Bytes, das 
dem letzten assemblierten Byte folgt, unterstellt. Wenn eın Ausdruck vor- 
handen ıst, muß eın programmrelativer Wert erzeugt werden, den der As- 
sembler als Anfangsadresse des Programms nımmt. Es sollte nur eine 
Startadresse angegeben werden, wenn ein Programm aus mehreren Quell- 
dateien assembliert wird. Wenn jedoch mehrere vorhanden sind, wird der 
Assembler das zuletzt verarbeitete nehmen. Wenn keine Startadresse ange- 
geben wird, beginnt die Programmausführung mit der ersten Programm- 
anweisung. Die Startadresse, sofern vorhanden, wird ın die Ausgabe der 
Objektdatei eingeschlossen. Wenn der Linker aus mehreren Modulen ein 
ausführbares Programm zusammenbaut, wird am Programmanfang ein 
Sprung zur Startadresse eingefügt. Wenn mehr als ein Modul mit einer 
Startadresse gefunden wird, wırd die letzte benutzt. 


symbol MACRO 


Beginn einer Makrodefinition: Dieser Pseudo-Befehl signalisiert den Beginn 
einer Makrodefinition. Das Symbol ıst erforderlich und gibt dem Makro 
seinen Namen. Mehr über Makros steht unten in "Die Makromöglichkeiten". 
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ENDM 


Ende einer Makrodefinition: Dieser Pseudo-Befehl sıgnalisiert das Ende 
eines Makros. 


[label] makroname [par[,par[,...]]] 


Makroaufruf: Dieser Pseudo-Befehl wird für den Aufruf (oder Erwei- 
terung) eines Makros benutzt. Das Label ist optional. Wenn angegeben, 
wird die programmrelative Adresse des ersten Bytes der Makroerweiterung 
unterstellt. Makroname ıst der dem Makro gegebene Name. Aktuelle Para- 
meter werden in einer durch Komma getrennten Liste im Operandenfeld 
angegeben. Parameter sind bloße Zeichenfolgen, die entsprechende Platz- 
halter im Makro selbst ersetzen. Wenn Leerzeichen, Komma oder Semiko- 
lons im Parameter sind, müssen sie mit Anführungszeichen (") oder Hoch- 
komma (?) gekennzeichnet werden. Wenn diese Zeichen innerhalb von Zei- 
chenketten vorkommen, müssen sıe doppelt angegeben werden. Fehlende 
Parameter werden als leere Zeichenkette interpretiert. Zwei aufeinander- 
folgende Kommas kennzeichnen einen fehlenden Parameter. Ein Parameter 
fehlt auch, wenn die Parameterliste nicht groß genug ist. 


Ausdrücke 


Ausdrücke können im Operandenfeld einiger Maschineninstruktionen oder 
Pseudo-Befehle erscheinen. Für die richtige Stellung der Ausdrücke in den 
Maschineninstruktionen siehe auch die Instruktionstabellen in Anhang D. 
Die Ausdrucksauswertung erzeugt immer einen binären 16-Bit-Wert. Wenn 
der Ausdruck im Operandenfeld eines Feldes erscheint, wird ihr Wert in 
die Objektdatei gebracht. Wenn die Instruktion weniger als 16 Bit erfor- 
dert, werden die höherwertigen Bits abgeschnitten. Ähnlich produzieren 
auch die Ausdrücke in den Pseudobefehlen DW und DB Werte ın der 
Objektdatei. 


Regeln für die Verschiebung 


Der Wert eines Ausdrucks ist entweder absolut oder programmrelativ, ab- 
hängig davon, ob und wie die Symbole benutzt werden. 


Programmrelative Teile in einer Objektdatei werden durch den Linker in 
absolute umgewandelt, sobald er einmal die absolute Adresse, an der das 
Modul stehen soll, errechnet hat, wohingegen absolute Teile unverändert 
geladen werden. 


Ein Label hat immer einen programmrelativen Wert, das heißt, daß sıe die 
programmrelative Adresse des nächsten zu assemblierenden Teils im Pro- 
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gramm unterstellt. Eine numerische Konstante ist aber absolut. Das Attribut 
für die Verschiebung eines Ausdrucks hängt von den Attributen seiner 
primären Terme und ihrer Kombination ab. Die folgende Tabelle zeigt die 
Regeln zur Bestimmung der Attribute zur Verschiebung eines Ausdrucks: 


KOMBINATION ERGEBNIS 


abs ? abs abs 
abs + rel rel 
abs ? rel Fehler 
rel + abs rel 
rel - abs rel 
rel - rel abs 
rel == rel abs 
rel < rel abs 
rel <= rel abs 
rel != rel abs 
rel > rel abs 
rel >= rel abs 
rel ? rel Fehler 


Ein Fragezeichen ın der Liste steht für jeden anderen Operator, als den- 
jenigen, der ausdrücklich für jede links- und rechtsseitige Kombination 
gezeigt wird. 


Normalerweise nehmen nur 16-Bit-Objektfelder verschiebare Ausdrücke 
auf. Ein verschiebarer Ausdruck kann jedoch für ein PC-relatives Feld er- 
scheinen; das heißt, ein Feld, das einen Offset mit Vorzeichen hat, der von 
der CPU zum Programmzähler addiert wird, um die effektive Adresse zu 
erhalten. Der Z80-Befehl JR (jump relative, relativer Sprung) ist ein Bei- 
spiel für dıe PC-relative Adressierung. In diesen Fällen nımmt MAC die 
Ausdrücke als Zieladresse. Vom Ausdruck subtrahiert er den Positions- 
zähler und die Instruktionslänge, wobeı er ihn zu einem absoluten Wert des 
folgenden Ausdrucks umwandelt. Wenn aber der Ausdruck eine absolute 
Adresse ergibt, nimmt MAC an, daß der Programmierer einen Offset zur 
gegenwärtigen Position anzeigen wollte; daher subtrahiert er nur die In- 
struktionslänge und stellt damit in Rechnung, daß die CPU den Offset nach 
Weiterstellung des PC anwendet. 


Zahlen 


Zahlen müssen Integer-Werte sein. Sie werden als dezimal angesehen so- 
lange nicht unmittelbar danach eın O oder Q (oktal) oder H (hexdazimal) 
folgt. 


Das erste Zeichen einer Zahl muß eine Ziffer sein. Eine führende Null 
kann erforderlich sein, damit hexadezimale Zahlen dieser Regel genügen. 
Zahlen werden ın 16-Bit-Werte umgewandelt und dann mit dem Rest des 
Ausdrucks (sofern vorhanden) kombiniert. 
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Symbole 


Symbole in einem Ausdruck müssen entweder irgendwo definiert oder als 
extern deklariert worden sein. Ein Symbol, das in einem Operandenfeld 
erscheint, kann durch ein Nummernzeichenpaar (##) abgeschlossen werden. 
Die Anweisung EXT erklärt Symbole als extern. Externe Symbole besitzen 
das programmrelative Attribut. Symbole, die mit den Pseudobefehlen SET 
und EQU definiert worden sind, wird das Attribut für die Verschiebung 
zugewiesen, das die Ausdrücke ıhrer Operandenfelder besitzen. 


Operatoren 


Die Ausdrucksoperatoren von Small-Mac sınd eın Subset von denen der 
Sprache C und folgen den gleichen Vorrang- und Ordnungsregeln. Sıe sind 
in der folgenden Tabelle aufgeführt. 
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| & bitweises UND >| 
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| *  bitweises exkl. ODER -> | 
#---- nn nunn nennen nennen nenne + 
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eo 00000 0 0 0 0 na 0 0 0 nn mn a mn a a a a an a a a + 
| || logisches ODER > | 
= ou. 0202000000 0 00 0 5 nn m a nn an m + 


Operatoren mit der höchsten Priorität stehen an der Spitze und alle Opera- 
toren im gleichen Kasten haben auch die gleiche Priorität. Pfeile zeigen die 
Reihenfolge der Anordnung. Man kann Klammern benutzen, um die An- 
ordnung zu kontrollieren. Jede Schachtelungstiefe ıst erlaubt. 
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Die aktuelle Instruktionsadresse 


Man kann das Dollarzeichen als Label für die Adresse der aktuellen In- 
struktion auffassen. Es hat das Attribut programmrelatiıv. 


Die Makro-Möglichkeiten 


Quellzeilen, die sıch zwischen den Makro-Pseudobefehlen MACRO und 
ENDM befinden, sınd das eigentliche Makro. Während des ersten Assemb- 
lerlaufs werden sıe in einem Puffer untergebracht. Beim zweiten Lauf wer- 
den an dem Punkt, an dem der Makroname ım Öperationsfeld gefunden 
wird, die Makroquellzeilen eingefügt. Dies wird als Makroerweiterung oder 
als Makroaufruf bezeichnet. Der erste Term leitet sich davon ab, daß eine 
einzige Instuktion zu einem ganzen Instruktionssatz erweitert wird. Der 
zweite Term macht sich die Analogie zu den Unterprogrammaufrufen zu 
eigen. Makros werden in der Tat auch als offene oder Inline-Unterpro- 
gramme bezeichnet. Makroaufrufe müssen ihrer Definition in der Quell- 
dateı folgen. 


Eine Schachtelung von Makrodefinitionen und Makroaufrufen ist nicht er- 
laubt. Wenn mehr als eine Makrodefiniton den gleichen Namen hat, wird 
nur die erste benutzt. 


Ersetzung der Parameter 


Parameter können bei jedem Makroaufruf angegeben werden, damit der 
erweiterte Code sıch für den speziellen Aufruf maßschneidern läßt. Man 
kann für den ersten Parameter ganz einfach ?1 in das Makro einfügen, ?2 
für den zweiten und °?0 für den zehnten und letzten. Es sind höchstens 
zehn Parameter erlaubt. Parameter ın einem Makroaufruf werden durch 
ihre Position identifiziert und durch Komma getrennt. Aufeinanderfolgende 
Kommas oder fehlende Parameter am Ende erzeugen keine Ersetzung. Das 
heißt, der für die Substitution vorgesehene Parameter wird aus dem er- 
weiterten Text entfernt. Wenn man ein ? im erweiterten Text braucht, muß 
man ?? codieren. Anführungszeichen oder Hochkommas können einen 
Parameter einschließen, der Leerzeichen enthält. Müssen diese Zeichen 
auch innerhalb des Makros erscheinen, müssen sie doppelt im Makro co- 
diert werden. 


Die Ersetzung der Parameter erfolgt ohne Rücksicht auf den Kontext. Da- 
her erfolgen die Ersetzungen auch innerhalb von Zeichenketten mit An- 
führungszeichen, Kommentaren und sogar Symbolen und Mnemonics. Man 
kann dieses einfache Konzept zu seinem Vorteil verwenden. 
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Lokale Label 


Zehn Label, dıe lokal zu jeder Makroerweiterung sınd, können im Makro 
als @0 bis @9 gekennzeichnet werden. Das erste dieser vom Assembler ge- 
fundenen Label erscheint im erweiterten Text als @l, das zweite als (@2, 
und so weiter. Diese Folge erhöht sich während des Programms fortlaufend, 
so daß gewährleistet ıst, daß jedes Label und seine Verweise nur einmal 
vorkommen. Dies vermeidet den Fehler "redundant definition", wenn das- 
selbe Makro wiederholt aufgerufen wird. 


Laden und Ausführen 


Manchmal müssen Programme entwickelt werden, die an anderen und nicht 
den üblichen CP/M-TPA-Adressen starten. Häufig sind solche Programme 
besondere Gerätetreiber oder andere BIOS-Erweiterungen, die gewöhnlich 
bei einem Kaltstart aufgerufen werden. Small-Mac hat deswegen ein be- 
sonderes Laden-und-Ausführen-Programm, den Lader LGO. LGO lädt und 
übergibt wahlweise die Kontrolle an Programme, die von LINK mit dem 
besonderen Laden-und-Ausführen-Format erzeugt wurden. 


Der Schalter -G# sorgt dafür, daß LINK ein Laden-und-Ausführen-Pro- 
gramm erzeugt. Das Nummernzeichen (#) gibt die hexadezimale Adresse 
an, an der das Programm starten soll. Laden-und-ausführen-Programme 
enthalten eine RET-Anweisung zum CP/M, so daß Versuche, sie als nor- 
male CP/M-Befehle zu benutzen (durch Umbenennung der Dateinamener- 
weiterung) zum Scheitern verurteilt sind. Nach der RET-Anweisung folgen 
Definitionen für die Startadresse, die Länge ın Bytes und die Startadresse. 
Diese Information wird von LGO benutzt, um genau die richtige Anzahl 
der Bytes an die richtige Adresse zu laden und um (wahlweise) mit der 
Ausführung am richtigen Ort beginnen zu können. 


Es liegt in der Verantwortung des Progammierers sicherzustellen, daß dies 
während folgender Betriebssystemsoperationen keine Probleme verursacht. 
Man sollte in den CP/M-Handbüchern die richtige Technik nachlesen. 
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Die Benutzerschnittstelle 


Der Aufruf von Small-Mac-Programmen besteht aus: 


1. dem Programmnamen mit optionaler Laufwerksangabe ım Standard- 
CP/M-Format, 

2. Umienkungsangaben für Standard- Ausgabedateien und 

3. Schaltern, die den Ablauf des Programms kontrollieren. 


Standardein- und -ausgabe 


Small-Mac-Programme unterstüzten die Unix-ähnliche Umlenkung von 
Standarddateien. Eine Standarddateı ist eine Datei, dıe automatisch bei der 
Programmausführung geöffnet wird. Üblicherweise wird die Standardein- 
gabe der Tastatur zugewiesen und die Standardausgabe dem Bildschirm. 


Man kann die Standardeingabe von der Tastatur durch ein < in der Be- 
fehlszeile mit nachfolgender neuer Quelle auf diese Quelle umlenken. Dies 
kann eine Datei (komplett mit Erweiterung und Laufwerksangabe) oder ein 
logisches Gerät wıe RDR: sein. 


Genauso kann man auch die Standardausgabe vom Bildschirm durch ein > 
ın der Befehlszeile umlenken. Wenn die Standardausgabe durch ein >> um- 
gelenkt wird (zum Beispiel >>DATEI3), wird die Ausgabe an die schon 
vorhandenen Daten angehängt, was auch immer schon vorhanden gewesen 
sein mag. Wenn die Datei noch nicht besteht, wird sıe angelegt und >> 
unterscheidet sıch nicht von >. 


Beide Umlenkungsanweisungen können gleichzeitig in jeder Position nach 
dem Programmnamen in der Befehlszeile erscheinen. Man sollte darauf 
achten, nicht Eingabe und Ausgabe der gleichen Datei zuzuweisen; das Er- 
gebnis wäre eine zerstörte Datei. 


Small-Mac-Programme benutzen die Standardeingabe nur für Antworten 
auf Fehlermeldungen über die Tastatur, so daß für eine Umlenkung keine 
Notwendigkeit bestehen sollte. Für Fehlermeldungen und Listings wird die 
Standardausgabe benutzt, die somit standardmäßig zum Bildschirm geht. 


Parameter in der Befehlszeile 


Schalter bestehen aus einem Bindestrich, gefolgt von einem oder zwei 
Buchstaben und eventuell von einem numerischen Wert. Die Buchstaben für 
die Schalter sind nach mnemonischen Aspekten gewählt worden. Außer bei 
LIB können alle Schalter in Small-Mac-Programmen in jeder Position hin- 
ter dem Dateinamen erscheinen. LIB benutzt nur einen Schalter, der als er- 
ster in der Befehlszeile erscheinen muß. 
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Small-Mac-Programme interpretieren Buchstaben, die keine Schalter sind, 
als Dateinamen. Die Reihenfolge kann einen Unterschied bewirken. Die 
Details sind in den einzelnen Programmbeschreibungen weiter unten aufge- 
führt 


Bedienungshinweise 


Damit man sıch an die verschiedenen Schalter und Parameter bei der Be- 
nutzung von Small-Mac-Programmen besser erinnern kann, erscheint auf 
dem Bildschirm immer dann ein Bedienungshinweis, wenn Small-Mac ohne 
Schalterbuchstaben oder mit einem nicht definierten Schalter aufgerufen 
wird. Wenn man Hilfe braucht, um sıch an die verschiedenen Schalter zu 
erinnern, braucht man nur den Programmnamen gefolgt von einem Binde- 
strich einzugeben. Bedienungshinweise zeigen die Aufruf-Syntax der Small- 
Mac-Programme; sıe haben die Form 


usage: <program> <switch>... <file>... 


wobei <program> der Programmname ist, <switch> ist ein Schalter und 
<file> ist ein Dateiname. Die Zeichen < und > sind nicht Teil der Syntax. 
Sie zeigen nur an, daß ein gültiger Term eingeschlossen wurde. 


Angaben zur Umlenkung werden im Bedienungshinweis nicht gezeigt, da 
sie bei allen Programmen gleich sind; ihre Verfügbarkeit kann angenommen 
werden. Eckige Klammern im Bedienungshinweis geben optionale Felder 
an. Die Klammern sind nicht Teil der Kommandos. 


Programme nehmen einen Standardablauf, wenn ein optionaler Schalter 
fehlt. Der Ablauf orientiert sich an der üblichen Vorgehensweise, so daß 
Schalter nur in Sonderfällen gebraucht werden. LIB ıst eine Ausnahme, da 
ihm immer gesagt werden muß, wie es zu verfahren hat. 


Punkte erscheinen in der Benutzungsmeldung um anzuzeigen, daß ein ge- 
gebener Feldtyp mehr als einmal ım Befehl erscheinen kann. Die Punkte 
selbst sind nıcht Teil des Kommandos. 


Worte oder Kombinationen aus Wörtern werden als gültige Namen für be- 
sondere Parameterarten verwendet. Zum Beispiel steht source für eine As- 
sembler-Eıngabedateıi. 


Fehlerbehandlung 


Alle Small-Mac-Programme schicken Fehlermeldungen zur Standardaus- 
gabe. Bei einem fatalen Fehler bricht das Programm mit hörbarem Alarm 
ab. Wenn möglich, versucht das Programm ganz durchzulaufen, ehe es ab- 
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bricht. Einige Fehler jedoch (zum Beispiel Fehler in der Befehlszeile) kön- 
nen zum sofortigen Ende des Programms führen. 


Zwei Fehler werden vom Small-C-Laufzeitsystem und nicht vom Pro- 
gramm selbst gefunden: 


l. R, Fehler bei der Umilenkung, der anzeigt, daß versucht wurde, die 
Standardeingabe zu einer nicht existierende Datei umzulenken. Dies 
sollte eigentlich nicht vorkommen, da es keinen Grund gibt die Stan- 
dardeingabe von Small-Mac umzulenken. 

2. M, Speicherzuordnungsfehler, der anzeigt, daß versucht wurde, mehr 
Speicher zuzuordnen als verfügbar ist. 


Programmkontrolle 


Man kann jedes Programm im Small-Mac-Paket während des Laufs ab- 
brechen. Um ein Programm zeitweise anzuhalten, kann man Control-S ein- 
geben. Der Druck auf eine beliebige andere Taste nimmt die Programm- 
ausführung wieder auf. Zum Programmabbruch kann man Control-C ein- 
geben. 
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MAC: Der Small-Mac-Makroassembler 


Bedienung 
MAC [-L] [-NM] [-P] [-S#] [object] source... 


-L Assemblerlisting erzeugen 

-NM keine Makroverarbeitung 

-P Pause beı Fehlern 

-5# die Größe der Symboltabelle auf # Symbole einstellen 


object Name der Objektdatei 
source... Namen der Quelldateien 


Quelldateien 


Man muß mindestens eine Quelldatei in der Befehlszeile angeben. Wenn 
mehr als eine angegeben wird, werden sie in der angegebenen Reihenfolge 
zu einem Modul assembliert. Man kann bei den Quelldateien auch eine 
Laufwerksbezeichnung angeben, um Quelldateien von verschiedenen Lauf- 
werken zu lesen. Wenn kein Laufwerk angegeben wird, wird das Standard- 
laufwerk genommen. Wenn die Quelldateı nıcht gefunden wird, bricht 
MAC mit einer Fehlermeldung ab. Die Standard- und einzige erlaubte 
Dateinamenserweiterung ist MAC. 


Die Objektdatei 


Man kann eine Objektdatei angeben. Wenn keine angegeben wird, wird der 
Objektcode auf dem Standardlaufwerk in einer Datei abgelegt, die den 
gleichen Namen trägt, wie die erste Quelldatei, aber mit der Erweiterung 
REL. Man kann für die Objektdatei ein Laufwerk angeben, um die REL- 
Datei auf diesem Laufwerk zu speichern. Wenn kein Laufwerk angegeben 
ist, wird das Standardlaufwerk genommen. Die Objektdatei muß die Erwei- 
terung REL haben, zur Unterscheidung von Quelldateien. Der Modulname 
in der Objektdatei wird aus den ersten sechs Zeichen des Objektdatei- 
namens gebildet. 


Das Assembler-Listing 


Ein Assembler-Listing wird nur erzeugt, wenn der Schalter -L in der Be- 
fehlszeile angegeben wurde. Das Listing und die Fehlermeldungen werden 
zur Standardausgabe geschickt und gehen daher zum Bildschirm, sofern 
nicht umgelenkt wird. 
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Fehlermeldungen erscheinen in der gleichen Zeile wie der Fehler. Wenn je- 
doch kein Listing erzeugt werden soll, wird jede fehlerhafte Zeile vor der 
eigentlichen Fehlermeldung gedruckt. 


Die Listingausgabe ist für Seiten mit einer Höhe von 11 Zoll vorgesehen. 
Man sollte entweder einen breiten Drucker benutzen oder die Listings in 
komprimierter Schrift ausdrucken. 


Jede Zeile ım Listing enthält (von links nach rechts): 


die dezimale Quellzeilennummer 

den aktuellen hexadezimalen Positionszählerwert 

den durch die aktuelle Quellzeile generierten Objektcode 
die Quellzeile 


O0O000 


Die ım Programm verschiebaren Teile sind in der Objektspalte mit einem 
Hochkomma gekennzeichnet. Alles andere ist absolut. Wenn der Objektcode 
nicht in den zugewiesenen Platz paßt, werden Überlaufzeilen gedruckt. 


Eine sortierte Symboltabelle wird am Ende des Listings gedruckt. Jede 
Zeile zeigt den Symbolwert, das Attribut für dıe Verschiebung, das Symbol 
und den Symboltyp. Symboltypen werden durch folgende nachgestellte Zei- 
chen markiert: 


: Label 
: Einsprungspunkt 
## externe Referenz 


Übergehen von Makros 


Man kann den Schalter -NM mit der Bedeutung "keine Makros" ("no 
macros") angeben, wenn die Makroverarbeitung nicht erwünscht ist. Dies 
beschleunigt den Assembler um 13%. Makroverarbeitung wird für Pro- 
gramme, die vom Small-C-Compiler erzeugt werden, nicht gebraucht. 


Pause bei Fehlern 


Beim Schalter -P hält MAC an, nachdem er die Fehler für jede Zeile aus- 
gegeben hat. Er wartet dann solange, bis RETURN eingegeben wird. 


Größe der Symboltabelle 


Der Schalter -S# bestimmt die Größe der Symboltabelle. Das Nummernzei- 
chen steht für eine dezimale Integer ohne Vorzeichen. Sie gibt die maxiı- 
male Anzahl der Symbole in der Tabelle an. Da die Geschwindigkeit mit 
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der Annäherung an die Kapazitätsgrenze abnımmt, sollte man etwas Platz 
freilassen. Die Standard-Tabellengröße beträgt 500 Symbole. 


Der Speicherplatz, der nach der Zuordnung der Symboltabelle noch frei ist, 
wird als Makropuffer verwendet. Je größer die Symboltabelle ist, desto 
weniger Platz bleibt für die Makrodefinitionen; je kleiner die Symboltabelle 
ist, desto mehr Platz bleibt für die Symboltabelle. 


Wenn man ein Assemblerprogramm mit ungefähr 400 Symbolen oder mehr 
benötigt, sollte man -S# benutzen um die Größe der Symboltabelle zu er- 
höhen. Wenn man auf der anderen Seite die Fehlermeldung "Macro Buffer 
Overflow" erhält, sollte man die Symboltabelle verkleinern. 


Beispiele 
BEFEHL BESCHREIBUNG 


MAC PROG 
Assembliert PROG.MAC, erzeugt PROG.REL auf dem Stan- 
dardlaufwerk, produziert kein Listing und hält bei Fehlern 
nicht an. 

MAC PROG PROG2 -L -P 
Assembliert PROG.MAC und PROG2.MAC, erzeugt PROG. 
REL auf dem Standardlaufwerk. Gibt ein Listing auf dem 
Bildschirm aus und hält bei Fehlern an. 

MAC P1 P2 P3 B:P.REL -NM 
Assembliert PI.MAC, P2.MAC und P3.MAC und erzeugt 
P.REL auf Laufwerk B. Produziert kein Listing, hält bei 
Fehlern nicht an und verarbeitet keine Makros. 

MAC PROG -L >LST: 
Assembliert PROG.MAC und PROG2.MAC und erzeugt 
PROG.REL auf dem Standardlaufwerk. Gibt ein Listing auf 
LST: aus und hält bei Fehlern nicht an. 


Normale Meldungen 
MELDUNG ERKLÄRUNG 


Waiting... 
MAC wartet auf ein RETURN von der Tastatur. 
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Fehlermeldungen 
MELDUNG ERKLÄRUNG 


Backward Movement 
Ein ORG würde den Positionszähler des Assemblers rück- 
wärts bewegen. 
Bad Data 
Eın DW oder DB gibt ungültige Daten an. 
Bad Expression 
Im Operandenfeld steht ein ungültiger Ausdruck. 
Bad Label 
Im Feld Symbol/Label steht ein ungültiges Label. 
Bad Operation 
Ein Mnemonik kann ın der Maschineninstruktionstabelle 
nicht gefunden werden. 
Bad Parameter 
Eın Makroaufruf gibt zu viele Parameter an. 
Bad Symbol 
Ein ungültiges Symbol ist gefunden worden. 
XXXXXXXX - Can't Open 
Die Datei xxxxxxx kann nicht geöffnet werden. 
Close Error 
Eine Dateı kann nicht richtig geschlossen werden. 
Invalid Extension 
Eine Datei aus der Befehlszeile enthält eine falsche Erweite- 
rung. 
Macro Buffer Overflow 
Der Makrotext-Puffer ıst übergelaufen. 
Missing END 
Bei einer Eingabedatei fehlt der Pseudobefehl END. 
Missing ENDM 
Innerhalb einer Makrodefinition wurde das Ende einer 
Quelldatei entdeckt. | 
Redundant Definition 
Das gleiche Symbol erscheint mehr als einmal im Feld Sym- 
bol/Label. Nur SET ist für eine Neudefinition von Symbolen 
erlaubt und nur bei denen, die ursprünglich von ihm defi- 
niert wurden. 
Relocation Error 
Eın 8-Bit-Feld wurde zu einem programmrelativen Wert be- 
rechnet oder der Ausdruck beı einer END-Anweisung ist 
nicht programmrelatıv. 
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Symbol Table Overflow 
Es passen keine Symbole mehr in die Symboltabelle. 
XXXXXXXX — Too Long 
Die Befehlszeile enthält einen Dateinamen, der zu lang ist. 
Undefined Symbol 
Das Operandenfeld enthält einen Verweis auf ein undefi- 
niertes Symbol. 
Write Error in REL File 
Bei der Ausgabe der Objektdatei ist ein Fehler aufgetreten. 
Wahrscheinlich ist auf dem Laufwerk kein Platz mehr. 
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LNK: Der Small-Mac Linker 


Bedienung 
LNK [-B) [-G] [-M]) program [module/library...] 
-B Es soll ein großes Programm (Big) gelinkt werden. Der ganze 


verfügbare Speicherplatz wird für die Symboltabelle reser- 
viert und das Programm wird komplett auf dem Laufwerk 


gepuffert. 

-G# Eine LGO-Dateı (Laden-und-ausführen) ausgeben, für Aus- 
führung an Adresse #. 

-M Die Aktivitäten des Linkers beobachten (Monitor). 


program Ein zu linkendes Programm. 

module/library... 
Eine Liste von keiner oder mehreren Dateien und/oder Bib- 
lıotheksdateien (.LIB). 


Funktionale Beschreibung 


LNK führt primär drei Aufagben durch: es kombiniert separat assemblierte 
Module in ein einziges Programm, löst externe Referenzen auf und addiert 
die Basiısadresse von jedem Modul zu allen darin enthaltenen programm- 
relativen Teilen und wandelt sie dadurch in absolute Adressen um. 


Diese Arbeit wird ın zwei Durchgängen ausgeführt. Zuerst wird die 
Befehlszeile nach Modul- und Bibliotheksnamen durchsucht. Jedes ın der 
Befehlszeile aufgeführte Modul wird ın einen Puffer hinter das vorige Mo- 
dul geladen. Während jedes Modul geladen wird, wird eine temporäre Datei 
mit Zeigern auf programmrelative Teile für die Benutzung im zweiten 
Durchgang ın eine Referenzdatei (.R$) geschrieben. Ebenso werden Ein- 
sprungspunkte und externe Referenzen in eine Symboltabelle geladen, um 
die externen Referenzen aufzulösen. 


Die Symboltabelle ıst als zwei miteinander verkettete Listen aufgebaut, an- 
geordnet ın alphanumerischer Reihenfolge, eine für externe Referenzen 
und eine für Einsprungspunkte. Jede Eintragung ın der Symboltabelle ent- 
hält einen Kettenzeiger, den Namen eines Symbols und eine 16-Bit- 
Adresse. Im Falle eines Einsprungpunktes ist der Wert die Einsprungs- 
adresse. Im Falle einer externen Referenz ist es die Adresse auf den Ket- 
tenkopf von Adressen für dieses Symbol. LNK löst externe Referenzen auf, 
indem jeder Verweis in der Kette durch den entsprechenden Wert des Ein- 
sprungpunktes ersetzt wird. 
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Nachdem jedes Modul geladen wurde, versucht LNK alle externen Refe- 
renzen, die mit Einsprungspunkten im neuen Modul übereinstimmen, auf- 
zulösen. Sobald jede externe Referenz aufgelöst wird, wird ihr Platz ın der 
Symboltabelle für spätere Benutzung freigegeben. Neue externe Referenzen 
benutzen diesen freien Platz, bevor die Tabelle erweitert wird. Einsprungs- 
punkte müssen in der Tabelle verbleiben, für den Fall, daß neue Module 
auf sie Bezug nehmen. 


Wenn LNK eine Datei mit der Erweiterung LIB findet, wird vermutet, daß 
es sich um eine Bibliothek handelt. In diesem Fall erfolgt eine Suche nach 
den Bibliotheksmodulen, die Einsprungspunkte enthalten, die bis jetzt noch 
nicht aufgelöst werden konnten. Diese Suche wird durch die Tatsache er- 
leichtert, daß jeder ın dem Modul enthaltenene Einsprungspunkt am 
Modulanfang aufgeführt ist. Wenn keine Übereinstimmung gefunden wird, 
wird das Modul ausgelassen. Zur Beschleunigung dieses Ausslassungsprozeß 
wird eine Indexdatei benutzt (NDX), um die Position des nächsten Moduls 
zu erhalten. LNK geht sofort zum nächsten Modul, ohne das unerwünschte 
durchzulesen. Wenn die Suche beendet ist, wird die Bibliothek noch einmal 
rückwärts durchsucht, um Rückverweise auflösen zu können. Dies wird so- 
lange wiederholt, bis keine Module mehr zu laden sind. LNK fährt dann 
fort, die Befehlszeile nach weiteren Modulen und/oder Bibliotheken zu 
durchsuchen. 


Es reicht aus, ein Symbol als extern zu erklären, damit das Modul geladen 
wird. Es muß nicht ausdrücklich darauf Bezug genommen werden. 


Wenn die Befehlszeile ausgewertet ist, beginnt LNK. mit der zweiten Phase. 
Die Referenzdatei wird geschlossen und wieder für die Eingabe geöffnet. 
Dann wird der gepufferte Objektcode zur Ausgabedateı geschrieben (ent- 
weder COM oder LGO). Dabei wird jede Adresse mit der Adresse der 
Referenzdatei verglichen. Bei jeder Übereinstimmung ist ein relativer Teil 
gefunden worden, also addiert LNK einen Offset und macht so einen abso- 
luten Wert daraus. Die nächste Referenzadresse wird gelesen und der Pro- 
zeß wiederholt sich. Um die Diskettenkopfbewegungen während des zwei- 
ten Durchgangs gering zu halten, werden für die Referenzdatei zusätzliche 
Puffer benutzt. 


Der Schalter -B 


Normalerweise benutzt LNK allen verfügbaren Speicher zur Pufferung des 
Programmtextes (Objekt) und für die Symboltabelle. Es kann jedoch sein, 
daß nicht genug Platz für LNK, seine Symboltabelle und für das geladenen 
Programm vorhanden ıst. Wenn LNK bemerkt, daß das zu ladende Pro- 
gramm nicht ın den Speicher paßt, wird zusätzlich eine temporäre Datei 
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mit Erweiterung ".0$" angelegt. Die Verarbeitung geht dann wie vorher 
weiter, nur daß die jetzt folgenden Module ın diese Datei geladen werden. 
Dies verlangsamt den Ladeprozeß beträchtlich, geschieht aber auch nur bei 
größeren Programmen. 


Das untere Ende des Speichers wird für den Programmtext und das obere 
Ende für die Symboltabelle verwendet. Bei der Verarbeitung wächst jedes 
in die Richtung des anderen. Einen Überlauf erhält man dann, wenn sich 
das nächste zu ladende Modul mit einer imaginären Reserve von 200 Ein- 
trägen am Ende der Symboltabelle überlappen würde. Sogar nach Auslage- 
rung auf Diskette kann die Symboltabelle überlaufen, wenn die Reserve 
erschöpft ıst. An diesem Punkt bricht LNK mit der Meldung "Must Specify 
-B Switch" ("Schalter -B muß verwendet werden) ab. Wenn man LNK mit 
dem Schalter -B aufruft, wird sofort auf Diskette ausgelagert und der 
verfügbare Speicher wird nur für die Symboltabelle benutzt. Dies sollte das 
Laden eines Programms von jeder Größe erlauben. 


Der Schalter Laden-und- Ausführen 


Der Schalter -G# veranlaßt LNK, anstelle einer COM-Dateı eine LGO- 
Dateı zu erzeugen. Die Adresse, an der das Programm startet, wird durch 
eine hexadezimale Zahl mit vorangestelltem # gekennzeichnet. Der LGO- 
Lader muß benutzt werden, um das Programm zu laden und/oder auszu- 
führen. 


Der Monitor-Schalter 


Durch den Schalter -M können die Lade- und Link-Aktivitäten beobachtet 
werden. Auf der Standardausgabe wird eine Liste der geladenen Module 
ausgegeben, ihre Größe und ıhre Ladeadresse (Programmrelativ und abso- 
lut). 


Programm- und Modulnamen 


Wenigstens eın Modulname (REL-Datei) muß angegeben werden. Ein 
Dateiname ohne Erweiterungen wird als Modulname interpretiert. Das erste 
Modul bestimmt den Namen des ausgegebenen Programms. Nachfolgende 
Module werden zum Programm-Modul geladen, haben jedoch keinen Ein- 
fluß auf den Programmnamen. Wenn ein Modulname eine Erweiterung hat, 
muß sıe REL lauten. Wenn ein Laufwerk angegeben ist (zum Beispiel B:), 
wird es für die Suche nach der Eingabedatei benutzt. Die Ausgabe erfolgt 
jedoch immer auf das Standardlaufwerk. 
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Bibliotheksnamen 


Bibliotheken werden durch die Erweiterung LIB gekennzeichnet, die 
zusammen mit dem Dateinamen angegeben werden muß. Mit einer Lauf- 
werksangabe kann angegeben werden, wo nach der Bibliothek und dem In- 
dex gesucht werden soll. LNK erfordert, daß eine Indexdatei mit gleichem 
Namen sich auf dem gleichen Laufwerk befindet, aber mit der Erweiterung 
NDX 


Die Bibliothek C.LIB enthält die Standard-Laufzeitfunktionen von Small-C. 
Jedesmal, wenn man ein Small-C Programm lınkt, muß man C.LIB ange- 
ben. 


Das besondere Modul END 


Um das Linken von Small-C-Programmen zu erleichtern, achtet LNK auf 
ein Modul mit Namen END. Dieses Modul in C.LIB muß immer zuletzt ge- 
laden werden. Dies deshalb, weil es Anweisungen enthält, die den Beginn 
des freien Speichers kennzeichnen, bevor das Programm ausgeführt wird. 
Wenn LNK ein Modul mit diesem Namen lädt, wird es übergangen und am 
Ende des ersten Durchganges geht LNK zurück und lädt es als letztes. 
Wenn LNK mehr als ein Modul mit Namen END findet, wird nur das letz- 
te geladen. Dies kann nützlich sein, wenn man sich seine eigene Bibliothek 
zusammenstellen möchte. 


Beispiele 
BEFEHL KOMMENTAR 


LNK PROG -GEOOO 
Lädt PROG.REL, erzeugt PROG.LGO zur Ausführung an 
Adresse EO00. 

LNK P1 P2 C.LIB 
Linkt PI.REL, P2.REL und alle erforderlichen Module aus 
C.LIB und erzeugt Pl.COM zur Ausführung als Standard- 
CP/M-Befehl. 

LNK -B -M >LST: ABC C.LIB 
Linkt ABC.REL und alle erforderlichen Module aus C.LIB 
und erzeugt ABC.COM. ABC ıst sehr groß, daher wird es 
gänzlich auf die Diskette geladen. Aller verfügbarer Spei- 
cherplatz bleibt für die Symboltabelle übrig. Der Linkprozeß 
wird auf dem LST-Gerät angezeigt. 
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Normale Meldungen 
MELDUNG ERKLÄRUNG 


xxxx Bytes at yyyy zzzz mmmmmm 
Modul mmmmmm mit Länge xxxx wird an relative Adresse 
yyyy (absolut zzzz) geladen. Erscheint nur, wenn -M ange- 
geben wurde. 

xXXXxX Byte Buffer 
Der verfügbare Speicherplatz für die Symboltabelle und den 
Objektpuffer beträgt xxxx. Erscheint nur, wenn -M ange- 
geben wurde. 

xxxx Bytes (hex) 
Die Programmgröße ıst hexadezimal xxxx. 

XXXxx Bytes (dec) 
Die Programmgröße ist dezimal xxxxx. 

XXXxX Overflow Point | 
Die relative Adresse des ersten Moduls beim Überlauf ist 
xxxx. Erscheint nur, wenn LNK mit dem Symbol DEBUG 
kompiliert und -M angegeben wurde. 

Resolving xxxxxx to yyyYy Ä 
Um die externe Referenz xxxxxx aufzulösen startet LNK 
mit dem Kopf der Kette bei yyyy. Erscheint nur, wenn 
LNK mit dem Symbol DEBUG kompiliert und -M angege- 
ben wurde. 

Start in xxXxxxxx 
Eine Startadresse für Modul xxxxxx wurde angegeben. 


Fehlermeldungen 


MELDUNG ERKLÄRUNG 


Abnormal End of REL File 
Das Ende eines Moduls oder einer Bibliothek wurde er- 
reicht, ohne das das richtige Dateiendezeichen gefunden 
wurde. 

XXXXXXXX - Can't Open 
Die angegebene Dateı kann nicht geöffnet werden. 

Close Error 
Eine Datei kann nicht geschlossen werden. 

Corrupt Library or Index 
Bei dem Versuch, das nächste Modul ın der Bibliothek zu 
finden, trat ein Suchfehler auf. 

Corrupt Module 
In einem Modul oder einem Bibliotheksteil wurde ein nicht 
erkennbares Linkmodul gefunden. 
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Error Reading xXxXXXxXXXX 
Beim Lesen der genannten Datei trat ein Ein-/Ausgabe- 
Fehler auf. 

Error Writing xXXXxxXxXxxX 
Beim Schreiben auf die genannte Dateı trat ein Fehler auf. 
Höchstwahrscheinlich bedeutet dies, daß kein Platz mehr auf 
der Diskette ist. 

Invalid Extension 
Eine Datei aus der Befehlszeile enthält eine ungültige Er- 
weiterung. 

Must Specify -B Switch 
Es gibt nicht genug freien Speicherplatz, um die Symbol- 
tabelle und das Programm zu laden. LNK erneut mit dem 
Schalter -B aufrufen. 

Premature End of Index 
Der Index einer Bibliothek enthält nicht genug Einträge. 

Redundant: xXxxxxX 
Das genannte Symbol wird mehr als einmal als Einsprungs- 
punkt genannt. 

Seek Error in XXXxXXXxXX 
Bei dem Versuch, ein programmrelatives Modul in einer 
Uberlaufdatei zu finden, trat ein Suchfehler auf. Ursache 
könnte ein Problem mit der Überlaufdatei oder ein logischer 
Fehler in LNK sein. 

XXXXXXXX - Too Long 
Die Befehlszeile enthält einen zu langen Dateinamen. 

Unresolved: xXXXxXX 
Es wurde kein Einsprungspunkt gefunden, der mit der 
externen Referenz übereinstimmte. 

Unsupported Link Item 
Ein Eingabemodul enthält zwar ein erkennbares Modul, es 
ist aber nicht im Microsoft-Link-Format. 
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LGO: Der Small-Mac-Lader 


Bedienung 
LGO [-G] [-M) program 


-G Programm nach dem Laden ausführen. 
-M Ladeadresse, Größe und Anfangsadresse anzeigen. 
program Dateiname des zu ladenden Programms. 


Beschreibung 


LGO ist ein sehr einfacher Lader, um LGO-Dateien an ihre geplante 
Adresse zu laden und sie wahlweise zu starten. Sein prımärer Zweck ist es, 
die bequeme Installation von Betriebssystemserweiterungen beim Kaltstart 
zu erlauben. 


Wenn der Schalter -G# mit LNK benutzt wird, wırd eine besondere LGO- 
Dateı anstelle der normalen COM-Datei ausgegeben. Dateien zum Laden 
und Ausführen haben folgendes Format: 


TEIL BYTE 
RET-Anweisung 1 
Startadresse 2 
Basisadresse 2 
Programmgröße 2 
Objektprogramm <Größe> 


Die RET-Anweisung dient zwei Zwecken. Sie indentifiziert Dateien, die 
das Laden-und-Ausführen-Format haben und erzeugt einen Ausgang für 
die Fälle, in denen jemand versucht, die Datei in eine mit COM-Erweite- 
rung umzubenennen, um sıe dann als CP/M-Befehl auszuführen. 


Die Basisadresse und Größe sagen LGO genau, wohin das Programm zu la- 
den ıst und wieviele Bytes geladen werden. Nur die angezeigte Zahl der 
Bytes wird geladen. Dies Zahl wird von LNK errechnet, wenn die LGO- 
Datei erzeugt wird. Man sollte sich immer davon überzeugen, daß die 
LGO-Programme genau dahin geladen werden, wo man sie erwartet. 


Man sollte auch die CP/M-Dokumentation und die Dokumentation seiner 
speziellen CP/M-Implementation zu Rate ziehen, um zu sehen, wie CP/M 
den Programmbereich TPA (temporary program area) verwaltet. 


Wenn man ein LGO-Programm über CP/M setzt, gibt es keine Probleme. 
Wenn man es jedoch unter den CCP am oberen Ende der TPA setzt, muß 
man sein Programm so schreiben, daß die Adresse bei 0006 so geändert 
wird, daß sıe auf den Beginn des Programms zeigen, das wiederum einen 
Sprung zur Adresse im BDOS enthalten muß, die ursprünglich bei Adresse 
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0006 vorhanden war. Dies bewirkt, daß CP/M mit einer reduzierten TPA 
normal operiert, wobei das Programm intakt bleibt, sogar wenn normale 
Programme in der TPA ablaufen. 


Man kann nicht ein permanentes Programm ans untere Ende der TPA laden 
und die LGO-Dateı darf nicht überlagert werden, während sıe als normales 
Programm in der TPA ausgeführt wird. LGO ıst in Small-C geschrieben; 
daher liegt sein Stapel am oberen Ende der TPA. Um deshalb das obere 
Ende der TPA für die zu ladenden Programme zur Verfügung zu haben, 
stellt LGO seinen Stack hinter sıch an die ersten 256 Bytes. 


Wenn LGO ausgeführt wird, muß ein Programmname in der Befehlszeile 
angegeben werden. Wenn eine Erweiterung angegeben ıst, muß sie LGO 
heißen. 


LGO führt folgende Funktionen aus: 


Öffnet die genannte Datei. 

Stellt sicher, daß sie das Laden-und-Ausführen Format hat. 

Liest die Anfangsparameter. 

Lädt die angegeben Anzahl Bytes an die angegebene Adresse. 

Wenn -G angegeben wurde, wird die Kontrolle an die Startadresse 
übergeben. 


O00006°0 


Beispiele 
BEFEHL KOMMENTAR 


LGO DRIVER -G 
Lädt DRIVER.LGO an die geeignete Adresse und beginnt 
mit der Ausführung. 

LGO PROG -M 
Lädt PROG.LGO, zeigt die Ladeadresse, Größe und Start- 
adresse auf dem Bildschitm an und kehrt dann ıns CP/M 
zurück. 

LGO ABC 
Lädt ABC.LGO, und kehrt nach CP/M zurück 


Fehlermeldungen 
MELDUNG ERKLÄRUNG 


XXXXXXXX - Can't Open 
Die genannte Dateı kann nicht geöffnet werden. 

Error Reading xXxXXxxxxxX 
Ein Ein-/Ausgabe-Fehler ıst bei Lesen der angegebenen 
Datei aufgetreten. 
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Invalid Extension 
Eine in der Befehlszeile angegebene Dateı hat eine ungültige 
Erweiterung. 

Invalid LGO Format 
Die genannte Dateı hat kein korrktes Laden-und-Ausfüh- 
ren-Format. 

XXXXXXXX - Too Long 
Die Befehlszeile enthält einen Dateinamen, der zu lang ist. 
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LIB: Der Small-Mac-Bibliotheksverwalter 


Bedienung 
LIB -{DPTUX)[A] library [module...] 


-D Löscht dıe genannten Module 

-P[A] Druckt die genannten oder alle (-PA) Module 

-T[A] Druckt ein Verzeichnis der genannten oder (-TA) aller Mo- 
dule 

-U Genannte Module aktualisieren (hinzufügen/ersetzen) 

-X[A] Genannte oder alle (-XA) Module herauslösen 

Beschreibung 


LIB wird benutzt, um eine Bibliothek verschiebbarer Objektmodule zu ver- 
walten. Jedes Modul hat genau das gleiche Format wie ein frei stehendes 
(REL-Dateı). Jede Bibliothek besteht aus einer Verkettung von Objekt- 
modulen in einer Datei, die die Erweiterung LIB hat. Eine Indexdatei 
(NDX) muß jede Bibliothek begleiten. Die Indexdatei enthält eine Reihe 
von Wortpaaren, von denen jedes die Adresse des ersten Bytes eines Mo- 
duls ınnerhalb der Bibliothek angıbt. Das erste Wort zeigt auf den Block 
und das zweite in den Block. LNK und LIB benutzen diese Information, 
um direkt das nächste Bibliotheksmodul zu suchen. LIB verwaltet Biblio- 
theken in alphanumerischer Ordnung. 


Wenn LIB aufgerufen wird, muß der erste Parameter ein Schalter sein, der 
anzeigt, welche Funktion ausgeführt werden soll. Dieser muß vom Namen 
der in Frage kommenden Bibliothek gefolgt werden. Die Bibliothek kann 
die Erweiterung LIB haben (wird als Standard angenommen), aber keinen 
anderen. Eine Laufwerksangabe kann angegeben werden, um anzuzeigen, 
wo die Bibliothek gefunden werden kann. 


Immer wenn LIB eine Bibliothek anlegt oder ändert, wird auf dem gleichen 
Laufwerk eine neue Bibliothek mit der Erweiterung L$ und ein neuer In- 
dex mit Erweiterung N$ angelegt. Bei erfolgreichem Abschluß werden die 
ursprüngliche Bibliothek und der ursprünglicher Index gelöscht und die 
neuen Dateien mit permanenten Erweiterungen umbenannt. 


Die Schalter -D und -U erfordern eine Liste von Modulnamen, mit denen 
gearbeitet werden soll. Die anderen Befehle können entweder mit einer 
Liste der Module oder mit allen Modulen arbeiten. Die Liste kann auf drei 
Wegen angegeben werden: in der Befehlszeile, dem Bibliotheksnamen fol- 
gend, durch Eingabe über die Konsole oder von einer Datei mit Namen. 
Wenn die Namen in der Befehlszeile stehen, werden sıe als Liste ge- 
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nommen. Sonst erhält LIB die Namen von der Standardeingabe. Wenn die 
Standardeingabe auf eine Diskettendatei umgelenkt wurde, liest LIB die 
Dateı und erhält einen Namen pro Zeile. Wenn jedoch die Eingabe nicht 
umgeleitet wurde, fordert LIB jeden Namen über die Tastatur an. Eine 
leere Eingabe (nur Carriage-Return) sıgnalisiert das Ende der Eingabe. 


Die Schalter -P, -T und -X arbeiten mit jedem Modul in der Bibliothek, 
wenn die Namensliste leer ist; wenn also keine Namen in der Befehlszeile 
stehen und bei der ersten Anforderung keine Eingabe gemacht wurde oder 
wenn die Datei zu der die Standardeingabe umgelenkt wurde, leer ıst. Wenn 
man die Aufforderung vermeiden möchte und auch keine leere Datei ange- 
ben möchte, fügt man einfach den Buchstaben A an den Schalter hinzu, 
also -PA, -TA oder -XA. Namenslisten können ın jeder Reihenfolge er- 
scheinen. 


Modulnamen dürfen nur sechs Zeichen lang sein. Ein Dateiname kann je- 
doch acht Zeichen lang sein (ohne Laufwerksangabe und Erweiterung). In 
der Namensliste können Namen mit bis zu acht Zeichen enthalten sein. 
Solche Namen werden auf sechs Zeichen abgeschnitten, wenn sie sich auf 
Bibliotheksmodule beziehen. Der Schalter -U benutzt jedoch alle acht 
Zeichen, wenn nach freien Modulen gesucht wird, die in eine Bibliothek 
kopiert werden soll. Der Schalter -X benutzt nur sechs Zeichen, wenn er 
freie Module anlegt. Wenn Namen abgeschnitten werden sollen, zeigt LIB 
sıe auf dem Schirm und fragt, ob es weitermachen soll oder nicht. 


Module löschen 


Mit dem Schalter -D werden Module aus der existierenden Bibliothek ge- 
löscht. Jedes zu löschende Modul muß in der Namensliste angegeben sein. 


Bibliotheksmodule drucken 


Durch -P druckt LIB den Inhalt ausgewählter Module. Angegebene Module 
werden mit Programm-/Modulnamen, Programmgröße, Einsprungspunkte 
und der Programmendekennung gedruckt. Um Platz zu sparen, wird der 
Objekttext nicht gezeigt. Man kann DREL benutzen, um sich den voll- 
ständigen Inhalt der Module anzusehen. 


Ein Inhaltsverzeichnis drucken 


Durch den Schalter -T druckt LIB ein Inhaltsverzeichnis, also eine Liste 
der Modulnamen. Dies ist eine achtspaltige Liste in alphabetischer Reihen- 
folge, von links nach rechts und oben nach unten. 
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Eine Bibliothek anlegen oder aktualisieren 


Durch den Schalter -T aktualisiert LIB die genannten Module (hinzufügen 
und ersetzen). Für jeden angegebenen Namen wird ein Modul in die 
Bibliothek kopiert. Wenn ein Modul mit dem gleichen Namen schon in der 
alten Bibliothek vorhanden ıst, wird es ersetzt. 


Bevor mit der Aktualisierung fortgefahren wird, wird jede genannte Datei 
auf der Diskette gesucht. Wenn eine nicht gefunden wird, fragt LIB ob es 
weitermachen soll. Wenn die genannte Bibliothek nicht existiert, wird eine 
leere angelegt und das Verfahren geht normal weiter. 


Bibliotheksmodule herauslösen 


Mit dem Schalter -X (Extract) kopiert LIB die genannten Module aus der 
Bibliothek als alleinstehende Module auf die Diskette. Jede Dateı wird auf 
dem Standardlaufwerk mit REL-Erweiterung angelegt. 


Beispiele 
BEFEHL KOMMENTAR 


LIB -U M ABC DEF HIJ 
Aktualisiert M.LIB (und M.NDX) mit ABC.REL, DEF.REL, 
und HIJ.REL. 
LIB -X MY 
Löst Module aus MY.LIB heraus. Die Eingabe der Modul- 
namen erfolgt über die Tastatur. Wenn die erste Antwort 
eine leere Eingabe ıst (CR), werden alle Module extrahiert. 
LIB -D MY <ABC.LST | 
Löscht ın MY.LIB (und MY.NDX) alle ın der Datei 
ABC.LST genannten Module. 
LIB -P M GETREL 
Druckt das Modul GETREL aus M.LIB. 
LIB -TA C 
Gibt ein vollständiges Inhaltsverzeichnis von C.LIB aus. 


Normale Meldungen 
MELDUNG ERKLÄRUNG 


Added xXxXxXXxXX 
Das angegebene Modul ist zur Bibliothek hinzugefügt wor- 
den. 

Created XxXXXXX 
Die angegebene Datei ist als freies Modul angelegt worden. 
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Creating New Library 
Die angegebene Datei existiert nicht, also wird eine mit 
diesem Namen angelegt. 
Continue? 
Soll LIB weitermachen oder aufhören? 
Deleted XXXXxXxX 
Das angegebene Modul ist aus der Bibliothek entfernt wor- 
den. 
Module Name: xxXxxxXx 
Aufforderung für den nächsten Modulnamen. 
Replaced xxxxXxXx 
Das angegebene Modul ist ın der Bibliothek ersetzt worden. 


Fehlermeldungen 
MELDUNG ERKLÄRUNG 


XXXXXXXX - Can't Find - Ignored 
Die genannte Datei kann nicht gefunden werden und wird 
ignoriert. 
XXXXXXXX - Can't Open 
Die genannte Dateı kann nicht geöffnet werden. 
Can't Rename Files 
Die angeforderte Operation ist komplett, aber die Dateien 
können nicht in ihre permanten Erweiterungen umgewandelt 
werden. 
Close Error 
Eine Dateı kann nicht richtig geschlossen werden. 
Corrupt Library or Index 
Eine Indexsuche konnte den Beginn eines Moduls nicht fin- 
den. 
Delete by Name Only 
Die Module zum Löschen wurden nicht benannt. 
XXXXXXXX - Duplicate Name - Ignored 
Das gleiche Modul wurde mehr als einmal angegeben. 
Error Reading Index 
Ein Ein-/Ausgabe-Fehler ist aufgetreten, während die neue 
Indexdatei gelesen wurde. 
Error Writing New Index 
Ein Ein-/Ausgabe-Fehler ıst aufgetreten, während die neue 
Indexdatei geschrieben wurde. Wahrscheinlich ist die Disket- 
te voll. 
XXXXXXXX = Extension Forced to xxx 
Eine Dateierweiterung wurde angegeben. LIB ignoriert sie 
und verwendet stattdessen REL 
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Invalid Extension 
Eine Datei in der Befehlszeile enthält eine ungültige Erwei- 
terung. 
XXXXXXXX - Invalid Format - Ignored 
Es wurde ein ungültiges Dateinamensformat angegeben. Es 
wird ignoriert. 
Limited Stack Space 
LIB arbeitet mit begrenztem Stapelplatz. Fehler sind mög- 
lich. Es wird eine größere TPA gebraucht. 
Memory Overflow 
LIB kann nicht fortfahren, weil es nicht genug Speicher hat. 
Premature End of Index 
Das Ende der Indexdatei wurde vor dem Ende der Biblio- 
thek erreicht. 
Too Many Modules Specified 
LIB kann die Anzahl der angegeben Modulnamen nicht ver- 
arbeiten. LIB kann höchstens 200 Modulanmen aufnehmen. 
Es können mehrere Bibliotheken angelegt werden oder LIB 
kann erneut mit einem größeren Wert für MAXMODS kom- 
piliert werden. 
XXXXxxX Was Not in Library 
Das angegeben Modul wurde in der Bibliothek nicht gefun- 
den. 
XXXXXXXX - Will be Truncated to XXxxXxxX 
Der angegebene Dateiname wird, wie gezeigt, abgeschnitten. 
XXXXXXXX - Too Long 
Die Befehlszeile enthält einen Dateinamen, der zu lang ist. 
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CMIT: Die Small-Mac-Anpassungsutility 


Bedienung 
CMIT [-C) [-L)] [table] [mac] 


-C Passt den ausführbaren Assembler an die angegebene oder 
an die Standard-Maschineninstruktionstabelle (8080.MIT) an. 

-L Die kompilierte Maschineninstruktionstabelle listen. 

table Der Name der Maschineninstruktionstabelle im Quellformat. 

mac Name der Assembler-COM-Datei (Standard MAC.COM). 

Beschreibung 


CMIT wird benutzt, um die Maschineninstruktionstabelle vom externen 
Quellformat in internes Format zu kompilieren. In Anhang D sind die bei- 
den Maschineninstruktionstabellen abgedruckt, dıe Small-Mac beinhaltet. 


Wenn eınmal eine Tabelle kompiliert worden ist, wird sie gedruckt und/ 
oder in den ausführbaren Assembler kopiert und paßt damit Small-Mac an 
eine spezifische CPU an. 


Nachdem man einen neuen MAC.COM kompiliert und gelinkt hat, muß 
man ihn konfigurieren, indem man CMIT laufen läßt, bevor man ıhn aus- 
führen kann. Man kann einen schon konfigurierten MAC.COM jederzeit 
neu konfigurieren. 


CMIT erzeugt seine Listings aus der Objekttabelle. CMIT liest die Quell- 
tabelle ein zweites Mal und sucht jede Anweisung in der internen MI- 
Tabelle, wobei dieselben Funktionen wie beim Assembler benutzt werden. 
CMIT lJıstet dann jede Anweisung, zeigt die Quelle, die Anzahl der Ver- 
suche um sie in der internen MI-Tabelle zu finden und den Objektcode, 
der erzeugt wird, wenn die Anweisung assembliert wird. 


Wenn eine neue MI-Tabelle angelegt wird, muß man sorgfältig das Listing 
prüfen, ob es auch den korrekten Objektcode erzeugt. 


Der Schalter -C 


Mit dem Schalter -C konfiguriert CMIT den ausführbaren Assembler mit 
der kompilierten MI-Tabelle. 
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Der Schalter -L 


Der Schalter -L bewirkt, daß CMIT die kompilierte Tabelle auf der Stan- 
dardausgabe anzeigt. Die Ausgabe kann daher zu einem Drucker, zu einer 
Datei oder anderwohin umgelenkt werden. 


Wenn keine Schalter angegeben sınd, wird -L angenommen. Wenn jedoch 
irgendein Schalter vorhanden ist, wird nur die angeforderte Aktion durch- 
geführt. 


Benennung der Maschineninstruktionstabelle 


Wenn keine MIT-Quelldatei angegeben wird, wird 8080.MIT (auf dem 
Standardlaufwerk) angenommen. Ein Dateiname ohne Erweiterung oder mit 
Erweitwerung MIT bestimmt eine andere MIT-Quelldatei. Ein Laufwerk 
kann angegeben werden. 


Benennung des Zielassemblers 


Wenn kein ausführbarer Assembler genannt wird, wird MAC.COM auf dem 
Standardlaufwerk angenommen. Ein Dateiname mit der Erweiterung COM 
bestimmt eine andere Kopie des Assemblers. Ein Laufwerk kann angegeben 
werden. 


Beispiele 

BEFEHL KOMMENTAR 

CMIT | 
Kompiliert 8080.MIT (vom aktuellen Laufwerk) und listet 
die sich ergebende Tabelle. 

CMIT -C 


Kompiliert 8080.MIT (vom aktuellen Laufwerk) und bringt 
eine Kopie nach MAC.COM (auch auf dem aktuellen Lauf- 
werk). 

CMIT 280 B:MAC.COM 
Kompiliert Z80.MIT (vom aktuellen Laufwerk) und bringt 
eine Kopie nach B:BMAC.COM. 


Normale Meldungen 
MELDUNG ERKLÄRUNG 


Buffer Space Used nnnnn 
Die angezeigte Anzahl Bytes wurde als Puffer für die in- 
terne MI-Tabelle benutzt. 
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Operation Codes nnnnn 


Die angezeigt Zahl von eindeutigen Operationscodes 
(Mnemonics) wurden kompiliert. 


Fehlermeldungen 
MELDUNG ERKLÄRUNG 


XXXXXXXX - Write Error 
Ein Ein-/Ausgabe-Fehler ist während es Schreibens auf die 
angegebene Datei aufgetreten. Wahrscheinlich ist die Dis- 
kette voll. 
Bad Expression Specifier 
In der Quelldatei wurde eın ungüliger Ausdruck gefunden. 
Bad Hex Byte 
In der Quelldateiı wurde ein ungüliges hexadezimales Byte 
gefunden. 
Can't Find Instruction in MIT 
CMIT konnte bei der Überprüfung der Objekttabelle keine 
Anweisungsmnenomik finden. Wahrscheinlich ist dies einen 
Fehler ın der MIT. 
Can't Find Operand 
CMIT konnte bei der Überprüfung der Objekttabelle keine 
Anweisungsoperanden. Wahrscheinlich wurden in der Quell- 
datei Anweisungen mit den gleichen Mnemoniks getrennt. 
XXXXXXXX - Can't Open 
Die genannte Dateı konnte nicht geöffnet werden. 
Can't Rewind MIT File 
Die Quelldatei konnte nicht auf den Anfang positioniert 
werden. 
Close Error 
Eine Datei konnte nicht richtig geschlossen werden. 
Invalid Extension 
Eine Datei in der Befehlszeile enthält eine ungültige Erwei- 
terung. 
MIT Buffer Overflow 
Dem internen MIT-Puffer wurde unzureichender Platz zu- 
gewiesen. Dies kann durch Erhöhung des Wertes für MI- 
BUFSZ ın MAC.H, mit anschließender Neukompilierung 
von CMIT und MAC behoben werden. 
XXXXXXXX MIT is nnnnn Bytes but should be nnnnn 
Die Größe der internen MIT im angezeigten ausführbaren 
Assembler stimmt mit der Größe ın CMIT.COM nicht über- 
ein. Dies kann korrigiert werden, indem man überprüft, ob 
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MAC.H die richtigen Werte für MICOUNT, MIBUFSZ, und 
MIOPNDS enthält. Anschließend Neukompilierung von 
CMIT und MAC. 

MIT Mnemonic Overflow 
Der internen MIT für die Hashmnemonics wurde nicht ge- 
nügend Platz zugewiesen. Dies kann durch Erhöhung des 
Wertes für MICOUNT in MAC.H und anschließender Neu- 
kompilierung von CMIT und MAC behoben werden. 

MIT Operand Overflow 
Der ınternen MIT für Operanden wurde nicht genügend 
Platz zugewiesen. Dies kann durch Erhöhung des Wertes für 
MIOPNDS ın MAC.H und mit anschließender Neukompilie- 
rung von CMIT und MAC behoben werden. 

XXXXXXXxx - Too Long 
Die Befehlszeile enthält einen Dateinamen, der zu lang ist. 
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DREL: Dump relokatierbarer Objektdateien 


Bedienung 
DREL 


Beschreibung 


DREL erzeugt ein formatiertes Listing vom Inhalt einer Objektdatei. Aus- 
gegeben werden entweder einzelne Module oder Bibliotheken. Die Ausgabe 
geht zur Standardausgabe und kann daher zum Drucker, zu einer Datei 
oder anderswohin umgelenkt werden. 


Schalter in der Befehlszeile werden nicht akzeptiert. Man wird nach jeder 
auszugebenden Dateı gefragt. Wenn die Dateı nicht gefunden wird, wird 
man weitergefragt. Dateinamen müssen mit Erweiterung angegeben werden. 
Laufwerksangaben sind zugelassen. Eine leere Eingabe beendet DREL. 


Beispiel 
Library/module name: TEST.REL 
program: TEST 
prog size: OO8E"! 
load at: 0064 ' 
0064 0085' 05 00 EB CE 05 88 89 CD 0085' CD O08A' C3 
0074 10 00 21 0089: 21 10 00 3A 00 00 3A 0005+ 007D! 
0082 3A FFFB+ 0080: 01 32 03 34 05 36 07 38 09 
ext chain: 0083' EREF 
-» end prog: 0000 
- end file 


Library/module name: 


Die erste Spalte des Moduls zeigt die programmrelative Adresse des ersten 
Bytes, das rechts gezeigt wird. 


Werte ohne Zusatz sind absolut. Werte mit Hochkomma (’) sind programm- 
relativ. Werte mit einem Pluszeichen (+) sind Offsets, die LNK zur folgen- 
den externen Referenz addiert, nachdem sie aufgelöst worden ist. Daher 
nehmen diese Werte im Programm keinen Platz ein und der Positionszähler 
wird durch sie auch nicht erhöht. Dies muß man beachten, wenn man 
Werte ın einem Dump sucht. EREF ist eine externe Referenz mit dem 
Kopf der Kette bei 0083 hex. Versuchen Sie der Kette zu folgen. 


Der Wert "load at" wurde durch einen Pseudo-Op ORG oder DS erzeugt. 
Der absolute Wert von 0000 bei "end prog" zeigt, daß keine Startadresse an- 
gegeben wurde. 
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5 Small-Tools 


Brian W. Kernighan und P.J. Plauger haben ın dem Buch "Software Tools" 
eine Philosophie beschrieben, in der Programme als Werkzeuge zur Pro- 
blemlösung betrachtet werden. Jedes Programm oder Werkzeug ist dazu 
bestimmt, mit anderen Werkzeugen zusammenzuarbeiten. Jedes führt eine 
der Funktionen aus, die für eine vollständige Lösung des Problems ge- 
braucht werden. So ein Werkzeugsatz kann auf verschiedene Arten kombi- 
niert werden, um dann damit die gewünschten Ergebnisse zu erzielen. 


Der Schlüssel, um mit diesem Konzept arbeiten zu können, liegt darin, daß 
die Ausgabe jeder Funktion kompatibel zur Eingabe jeder Funktion sein 
muß. Die Werkzeuge müssen also flexibel sein; sie dürfen nicht zu viele 
Vermutungen über die durchzuführenden Funktionen anstellen. Sie sollten 
etwas vernünftiges machen, sogar wenn ihre Parameter ungewöhnlich sınd, 
da auch ungewöhnliche Effekte nützlich sein können. 


Der Hauptvorteil dieses Ansatzes für den Programmentwurf ist, daß jedes- 
mal wenn etwas benötigt wird, was sich nur gering von dem unterscheidet, 
was schon vorhanden ist, weder ein neues Programm entwickelt zu werden 
braucht, noch ein altes geändert werden muß. Vertrautheit mit den Funk- 
tionen und etwas Phantasie kann oft eine Lösung für ein neues Problem 
bringen. 


Das Small-Tools-Paket 


Small-Tools ıst eine Programmsammlung, die durch das Buch "Software 
Tools" inspiriert wurde. Die Programme wurden besonders zur Verwendung 
auf Eın-Platz-Mikrocomputersystemen entwickelt. 


Ihr Anwendungsbereich ist Textverarbeitung - ein Bereich mit hoher Akti- 
vität, buchstäblich in jeder Zeile. Die Aufgaben, für die sie geeignet sind 
(auf die sie aber nicht begrenzt sind) umfassen: 


Schreiben von Briefen, Berichten, Artikeln und Büchern, 

Prüfung auf Schreibfehler (englisch), 

Schreiben von Computerprogrammen, 

Anlegen von Formularen und Dokumenten durch Beantwortung von 
Fragen, 

Zusammenstellung sinnvoller Dokumente aus vorher geschriebenem 
Material und/oder Beantwortung von Fragen, 

oO  Adressdateien warten, 


OO 000 


oO 
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o Druck individueller Serienbriefe entweder einzeln oder über eine 
Adressdatei, 
o Briefumschläge und Etiketten bedrucken. 


Viele andere Möglichkeiten sind denkbar, abhängig von Notwendigkeit und 
Phantasie. 


Die Small-Tools-Programme 


Das Small-Tools-Paket besteht aus Programmen, die die folgenden Aufga- 
ben mit Textdateien durchführen können: 


Editieren 

Formatieren 

Sortieren 

Zusammenfügen 

Listen 

Drucken 

Suchen 

Ersetzen 

Übersetzen 

Kopieren und Aneinanderfügen 
Verschlüsseln und entschlüsseln 
Leerzeichen durch Tabs ersetzen 
Tabs durch Leerzeichen ersetzen 
Zeichen, Wörter oder Zeilen zählen 
Druckerzeichensatz wählen 


oOOoOo0o 00000000600 


oO 


Alle Programme arbeiten mit Dateien vom selben Format und man kann 
die Ausgabe eines Programms als Eingabe für ein anderes benutzen. Alter- 
nativ kann man die Ausgabe auch zur Konsole, zum Drucker oder zu je- 
dem am Computer angeschlossenen Gerät schicken. Genauso kann natürlich 
auch die Eingabe von der Konsole oder von einem mit dem Computer ver- 
bundenen Gerät kommen. 


Die Eingabe kann auch aus Disketten-Verzeichnissen stammen. Die beson- 
deren Dateinamen A:, B: und so weiter stellen dıe Verzeichnisse auf den 
entsprechenden Laufwerken dar (X: ıst das Standard-Laufwerk). Ein Ver- 
zeichnis sieht wie eine ASCII-Datei mit Dateinamen aus, einer pro Zeile. 
Diese Möglichkeit macht es einfach, Dateinamen zu wählen, um SUBMIT- 
Dateien für Operationen mit mehreren Dateien aufzubauen. 


Kombiniert können diese Programme eine Vielzahl von Aufgaben durch- 
führen. 
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Systemanforderungen 


Diese Implementation des Small-Tools-Paketes läuft auf 8080/8085/Z80- 
Maschinen mit dem Betriebssystem CP/M, einem Diskettenlaufwerke und 
56 KByte Speicher. Da diese Programme in Small-C geschrieben wurden 
und im Quellcode abgegeben werden, müssen sıe vor der Verwendung mit 
dem Small-C-Compiler kompiliert, mit dem Small-Mac-Makroassembler 
assembliert und mit LNK gelinkt werden (näheres dazu in Kapitel 6). 


Small-Tools, Konzepte und Möglichkeiten 


Dateiformat 


Jede Small-Tools-Dateı hat das gleiche Format. Eine Datei aus einer Folge 
von Zeilen. Wenn sich die Dateı auf Diskette befindet, folgt der letzten 
Zeile ein Dateiende-Byte mit dem Wert 26 dezimal oder 1A hex. In Fällen, 
wo die Datei mit dem letzten Byte des Sektors endet, wird das Dateiende- 
Byte nicht geschrieben. Wenn die Datei einem Ein-/Ausgabegerät zugewie- 
sen ist, wird auch kein Dateiende-Byte geschrieben. 


Eine Zeile besteht aus einer Folge von keinem oder mehr Zeichen, die 
durch zwei Zeichen, Carrıiage-Return (Wagenrücklauf) und Line-Feed 
(Zeilenvorschub) abgeschlossen werden. Eine Zeile kann höchstens 192 
Zeichen (außer den beiden eben erwähnten) enthalten. Wenn man die Daten 
über die Tastatur eingibt, wird die Zeile automatisch nach dem 192. Zei- 
chen beendet. Wenn Textdateien gelesen werden, unterbrechen die meisten 
Programme nach dem 192. Zeichen und beginnen die nächste Zeile mit 
dem folgenden Zeichen. 


Wenn die Ausgabe auf eine Dateı erfolgt, die schon existiert, wird sie 
überschrieben. Der Texteditor ist eine Ausnahme; zuerst nennt er die Datei 
ın eine Datei mit der Erweiterung $$$ um und löscht nach dem erfolg- 
reichen Schreiben die $$$-Datei. 


Die meisten Programme haben eine Eıngabe- und eine Ausgabedatei. Diese 
Standard-Dateien können zur Diskette oder zu Geräten umgeleitet werden. 
Ohne Umlenkung ist die Standardeingabe die Tastatur und die Standard- 
ausgabe dem Bildschirm zugeordnet. Man kann in der Befehlszeile Umlen- 
kungsanweisungen angeben, um diese Standard-Zuweisungen zu ändern. 


Die Umlenkungsanweisung für die Standardeingabe besteht aus dem Sym- 
bol "kleiner als" ("<"), sofort gefolgt von dem Dateinamen (im normalen 
CP/M-Format) oder einem logischen Gerätenamen (CON: oder RDR:) oder 
einem Inhaltsverzeichnis (A:, B:, ...., G:, X:). Die Zeichenkette <B:FILE3 
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leitet die Standardeingabe nach FILE3 auf Laufwerk B und <B: leitet dann 
weiter zum Verzeichnis auf Laufwerk B. 


Die Umlenkungsanweisung für die Standardausgabe benutzt das Symbol 
"größer als" (">"). Dateinamen oder logische Geräte (CON:, LST: oder PUN:) 
können benutzt werden. Natürlich können Verzeichnisse nicht für die Aus- 
gabe verwendet werden. Wenn die Standardausgabe durch ein Symbolpaar 
(zum Beispiel >>FILE3) umgelenkt wird, dann wird die Ausgabe an die 
schon vorhandenen Daten angehängt. Wenn die Datei noch nicht besteht, 
wird sıe angelegt und ">>" unterscheidet sich nicht von ">". 


Beide Umlenkungsanweisugen können gleichzeitig erscheinen und in jeder 
Reihenfolge und Position hinter dem Dateinamen in der Befehlszeile ste- 
hen. Man sollte Eingabe und Ausgabe nicht derselben Datei zuzuweisen; 
das Ergebnis wäre eine zerstörte Datei. 


Format der Befehlszeile 


Der Befehl zum Aufruf eines Small-Tools Programms besteht aus: 


l. dem Programmnamen mit wahlweiser Laufwerkangabe im Standard- 
CP/M-Format, 

2. Umlenkungsanweisung für Standardein- und -ausgabedateien, 

3. Parameter zur Steuerung des Programms. 


Ein oder mehrere Leerzeichen werden für die Trennung der Befehlsteile 
verwendet; daher kann ein Parameter keine Leerzeichen enthalten. Escape- 
sequenzen (später beschrieben) können benutzt werden, um Leerzeichen in 
Parameter anzugeben. 


Umilenkungsanweisungen werden von den Programmen nicht gesehen, des- 
halb können sie in jeder Reihenfolge nach dem Programmnamen erschei- 
nen. Die Position der Parameter kann jedoch wichtig sein. Das CHG-Pro- 
gramm (Change) zum Beispiel braucht zwei Parameter, ein Textmuster, 
nach dem in der Eingabedatei gesucht werden soll und eine Zeichenkette, 
die diese Textmuster in der Ausgabedatei ersetzt. Der erste Parameter wird 
immer als Suchmuster und der zweite immer als zu ersetzende Zeichenkette 
interpretiert. Sie müssen in dieser Reihenfolge erscheinen. 


Um effektiv zu sein, brauchen einige Programme Parameter ın Groß- und 
Kleinbuchstaben. Das CP/M-Programm SUBMIT und der CCP wandeln je- 
doch die Kleinbuchstaben in große um, bevor sie an das Programm weiter- 
gegeben werden. Für die Erkennung von Kleinbuchstaben sind deshalb im 
Anhang A Patches für den CCP und SUBMIT beschrieben. Nach diesen 
Patches kann man mit den CP/M-Utilities Dateinamen ın Kleinbuchstaben 
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angeben. Es ist zu empfehlen, Kleinbuchstaben nur bei Textmustern und zu 
ersetzenden Zeichenketten zu verwenden, da man bei CP/M-Dateinamen in 
Kleinbuchstaben auf Probleme stoßen kann. Die Small-Tools-Programme 
wandeln Dateinamen in Übereinstimmung mit CP/M-Konventionen immer 
ın Großbuchstaben um. 


Schalter in der Befehlszeile 


Eın Sonderklasse von Befehlszeilenparametern, Schalter genannt, wird oft 
benutzt, um sekundäre oder Nebeneffekte zu kontrollieren. Schalter beste- 
hen normalerweise aus einem Bindestrich, sofort von einem oder zwei 
Buchstaben gefolgt und in einigen Fällen von numerischen Werten. Der 
Schalter -BP123 zum Beispiel sagt dem Druckprogramm ab Seite (Page) 123 
mit dem Ausdruck zu beginnen. Wie die kursiven Zeichen anzeigen, soll 
man sich an Schalter leicht erinnern können. 


Schalter können ın der Befehlszeile ın jeder Position hinter dem Datei- 
namen erscheinen. Nur die Schalter, die keine Parameter sind, sind posi- 
tionsabhängig und das nur ın gegenseitiger Beziehung. Schalter und Umlen- 
kungsanweisungen können zwischen den anderen Parametern in jeder Folge 
erscheinen, ohne sie zu beeinflussen. 


Da Schaltern immer der Bindestrich vorausgeht, sollte man Dateinamen 
vermeiden, dıe mit einem Bindestrich beginnen (diese Namen, die eigent- 
lich keine Schalter sind, würden wie Schalter aussehen). 


Bedienungshinweise 


Damit man sich besser an die verschiedenen Schalter und Parameter erin- 
nern kann, die in diesem Programm benutzt werden, wird jedesmal auf 
dem Bildschirm ein Bedienungshinweis angezeigt, wenn man Small-Tools- 
Programme ohne Schalterbuchstaben oder mit nicht definierten Schaltern 
aufruft. Wenn man also Hilfe braucht, braucht man nur den Programm- 
namen, gefolgt von einem Bindetrich, einzugeben. Der Bedienungshinweis 
zeigt die Syntax für den Programmaufruf; sie haben die Form: 


usage: <Programm> <Parameter>... <Schalter>... 


wobei <Programm> der Programmname, <Parameter> eın Parameter, 
<Schalter> ein Schalter ist und die Punkte anzeigen, daß eınParameter 
mehrfach vorkommen kann. Schalter sind immer optional. Parameter kön- 
nen wahlweise sein oder nicht, je nach Programm. Umlenkungsanweisungen 
werden ım Bedienungshinweis nıcht gezeigt, da sıe allgemein beı den Pro- 
grammen verwendet werden können und ihre Verfügbarkeit angenommen 
werden kann. 
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Eckige Klammern ([]) erscheinen in den Bedienungshinweisen, um optiona- 
le Parameter anzuzeigen. Die Klammern sind nicht Teil des Befehls. Die 
Programme laufen mit Standardeinstellungen ab, wenn eine Angabe fehlt. 
Im Normalfall werden Schalter nur in Sonderfällen gebraucht. 


Punkte (...) erscheinen in den Bedienungshinweisen, um anzuzeigen, daß 
ein Feld mehr als einmal vorkommen kann. Die Punkte selbst sind nicht 
Teil des Befehls. 


Der senkrechte Strich (|) zeigt eine Alternative auf. Wenn man einen Bedie- 
nungshinweis liest, kann man den senkrechten Strich durch das Wort "oder" 
ersetzen. Genau wie die eckigen Klammern und die Punkte ist auch der 
senkrechte Strich nicht Teil des Befehls. 


Das Nummernzeichen (#) steht für eine dezimale Integer mit einer oder 
mehreren Ziffern. 


Das Fragezeichen (?) steht für ein Zeichen oder, in einigen Fällen, für eine 
Zeichenkette. Zahlen, Buchstaben und Sonderzeichen sind gültig. 


Worte oder Wortkombinationen stehen für gültige Namen von besonderen 
Parametertypen. Der Term outfile zum Beispiel steht für den Namen einer 
Ausgabedatei, das Wort pattern steht für ein gültiges Suchmuster und so 
weiter. 


Fehlerbehandlung 


Alle Small-Tools-Programme, mit Ausnahme des Texteditors, behandeln 
Fehler auf die gleiche Art und Weise. Bei einem Fehler wird eine Meldung 
angezeigt, ein Warnton ausgegeben und das Programm beendet. 


Besteht das Problem in einem ungültigen Kommando aus der Befehlszeile, 
wird der oben beschriebene Bedienungshinweis ausgegeben. Andere Fehler 
erzeugen andere geeignete Meldungen. 


Alle Small-Tools-Programme haben zwei Fehlermeldungen gemeinsam. Die 
Meldung "output error" zeigt einen Fehler während des Schreibens einer 
Ausgabedatei auf die Diskette an. Höchstwahrscheinlich ist nicht genug 
Platz auf der Diskette. Da diese Fehlermeldung allen Programmen gemein 
ist, wird sie nicht unten bei den einzelnen Programmbeschreibungen auf- 
geführt. Die zweite allgemeine Fehlermeldung lautet: "<Datei>: can’t open" . 
Dies bedeutet, daß auf der in Frage kommenden Diskette die Dateı nicht 
gefunden werden kann. 
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Zwei Fehler werden vom Laufzeitsystem gefunden und nicht vom Pro- 
gramm selbst: 


o R, Fehler bei der Umlenkungsanweisung, der einen Versuch anzeigt, 
die Standardeingabe auf eine nicht existierende Datei umzuleiten. 

o  M, Fehler bei der Speicherzuordnung, der einen Versuch anzeigt, mehr 
als den verfügbaren Speicher zuzuordnen. Dieser Fehler sollte niemals 
erscheinen. 


Escapesequenzen 


Manchmal ist es notwendig, nicht druckbare Zeichen oder Zeichen mit be- 
sonderer Bedeutung einzugeben. Man kann diese Zeichen über die Tastatur 
eingeben, wenn man den Doppelpunkt als Escape-Zeichen verwendet. Ein 
Escape-Zeichen ändert die Bedeutung des ihm folgenden Zeichens. 


Vom Programm werden das Escape-Zeichen und das ihm folgende Zeichen 
als ein einziges Zeichen gesehen. Die Escape-Zeichen sind: 


:b Backspace 

ın neue Zeile (Carriage Return) 
ıs Leerzeichen 

:Tt TAB 


:<zchn> das angegebene Zeichen 


Einige Zeichen, auch Metazeichen genannt, haben eine besondere Bedeu- 
tung, wenn sıe in Suchmustern oder in zu ersetzenden Zeichenketten er- 
scheinen. Man kann die Escapesequenz :<Zeichen> benutzen, damit sıe als 
Zeichen selbst im Kontext gesehen werden. 


Der Doppelpunkt ist ein Escape-Zeichen und muß zweimal angegeben wer- 
den, damit der Doppelpunkt selbst wırksam wird, also "::". 


Ein Leerzeichen muß mit :s angegeben werden, da ein Leerzeichen in 
einem Parameter diesen normalerweise beendet. 


Metazeichen 


Einige Zeichen haben eine besondere Bedeutung wenn sıe in Suchmustern 
oder zu ersetzenden Zeichenketten erscheinen. Als Gruppe bezeichnet man 
sie als Metazeichen (im Gegensatz zu den gewöhnlichen Zeichen). Da auch 
diese Metazeichen gelegentlich in einem Suchmuster oder in zu ersetzenden 
Zeichenketten erscheinen, müssen sie ın dıesen Fällen als Escape-Sequenz 
eingegeben werden. Alle Small-Tools-Programme benutzen die Definitionen 
der Metazeichen in TOOLS.H. Man kann dıe Zuweisungen nach Belieben 
ändern, indem man diese Datei vor dem Kompilieren ändert. 
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Hier eine Übersicht der Metazeichen: 


Symbol/Name Verwendung 


Escape-Zeıchen 

Anfang einer Zeile 

Ende einer Zeile 

jedes Zeichen 

kein oder mehrere Vorkommen eines Zeichens 

Beginn einer Zeichenklasse 

Ende einer Zeichenklassendefinition 

kennzeichnet in einer Zeichenklasse einen Zeichenbereich 
komplementiert eine Zeichenklasse 

2 steht in einer zu ersetzenden Zeichenkette für die ganze 
ursprüngliche Zeichenkette 
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Suchmuster 


Suchmuster werden vom Texteditor und einigen anderen Programmen be- 
nutzt, um ausgewählte Zeichenketten zu finden. Die einfachste Form eines 
Suchmusters ist eine Zeichenkette, die identisch zur gesuchten ist. 


Wenn dem Suchmuster ein Akzent vorausgeht, bedeutet das, daß die Zei- 
chenkette am Beginn einer Zeile erscheinen muß. An jeder anderen Posi- 
tion hat der Akzent keine besondere Bedeutung. 


Schließt das Muster mit einem Apostroph ab, bedeutet dies, daß die Zei- 
chenkette am Ende einer Zeile vorkommen muß. An jeder anderen Position 
hat der Apostroph keine besondere Bedeutung. 


Die folgenden Muster zeigen die Benutzung der Metazeichen: 


Muster Bedeutung 

'abcd die Zeichenkette "abcd" am Anfang einer Zeile 

xyz! die Zeichenkette "xyz" am Ende einer Zeile 

IxXxx' eine Zeile, die nur aus "xxx" besteht 

ab'cd'e die Zeichenkette "ab’cd‘e", die irgendwo in der Zeile vor- 
kommt 


Ein Fragezeichen ("?") in einem Muster findet jedes Zeichen an dieser 
Stelle der Zeichenkette. Also findet das Muster f??t foot, feet, fit und so 
weiter. 
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Ein Stern "*" findet kein oder mehr Vorkommen eines Zeichens. Ein Stern 
am Anfang eines Musters hat keine besondere Bedeutung. Die folgenden 
Beispiele zeigen die Benutzung des Sterns. 


Muster gefundene Zeichenkette 
kabc *abc 

a*bc bc, abc, aabc, aaabc, ... 
aa*bc abc, aabc, aaabc, aaaabc, ... 
s?*p sp, sxp, sleep, sl2 xp, .. 


the:s%*man theman, the man, the man, ... 


Man kann angeben, daß ein Zeichen an einer Stelle im Muster jedes aus 
einer Liste findet, aber keine anderen. Um dies zu erreichen, muß man nur 
die Liste der Zeichen in eckige Klammern einschließen. Zum Beispiel fin- 
det das Muster "ab[15Q]z" "ablz", "ab5z", "abQz", aber nicht "ab3z". 


Da die dezimalen Ziffern und die Klein- und Großbuchstaben oft benutzt 
werden und eine ziemlich lange Liste sind, existiert eine Abkürzung für 
"[012...9]", "[abc.. ‚Z), und "[ABC...Z]’. Man kann zwischen dem ersten und 
letzten Zeichen einen Bindestrich stellen. Demnach findet das Muster "a[0- 
9]" "a0", "al" und so weiter und das Muster "TA-Z][a-z]*" findet "A", "Able", 
"Zebra" und so weiter. 


Man braucht also nicht alle Ziffern oder alle Buchstaben bei dieser 
Schreibweise anzugeben. "[5-7]", "a-g" reicht aus. Es gib nur die Einschrän- 
kung, daß die "kleineren" Zeichen vor dem Bindestrich stehen müssen. Man 
kann diese Schreibweise bei einer Liste von Zeichen, die selbst eine 
Zeichenklasse bilden, anwenden. Also ist "[sl2g5-7a-zA-Z$(]" eine gültige 
Zeichenklasse. 


Der Bindestrich "-" hat seine besondere Bedeutung nur, wenn er zwischen 
Zeichen in einer Zeichenklassendefinition steht. Wenn er an einem Ende 
der Definition oder außerhalb einer solchen Definition steht, hat er keine 
besondere Bedeutung. 


Wenn das erste Zeichen nach einer linken eckigen Klammer eine Tilde ist 
("-"), bewirkt das, daß jedes Zeichen gefunden wird, außer den aufge- 
führten. 


Es ıst wichtig eine Zeichenklasse ımmer als eine einzige Zeichenposition zu 
sehen. 


Wenn man die Zeichen "[" und "]" in einem Muster braucht, kann man dies 
durch die Escapesequenzen "[" bzw. ":]" erreichen. 
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Eingabe über die Tastatur 


Jedesmal wenn man die Tastatur zur Eingabe benutzt, kann man Fehler vor 
dem Drücken der Return-Taste noch verbessern. Man kann Zeichen in um- 
gekehrter Reihenfolge löschen; dazu muß man nur für jede Löschung 
Backspace (BS) oder DEL drücken. Für jede Löschung wird auf der Kon- 
sole die Folge "Backspace-Leerzeichen-Backspace" ausgegeben; wenn die 
Konsole ein Bildschirm ist, verschwindet das letzte Zeichen in der Zeile. 
Drucker gehen einfach eine Druckposition zurück. Die ganze Zeile kann 
man durch Control-X löschen. 


Der CP/M-Druckerschalter (Control-P) arbeitet nicht mit Smalli-C-Pro- 
grammen. Er ist auch im allgemeinen nicht erforderlich, da man die Pro- 
grammausgabe auch auf LST: oder PUN: umlenken kann. 


Man kann ein Small-Tools-Programm, das gerade ausgeführt wird, anhalten 
oder abbrechen. Ein angehaltenes Programm wartet einfach solange, bis die 
Ausführung wieder aufgenommen wird. Durch Eingabe von Control-S 
stoppt das Programm und durch noch eines (oder Control-Q) geht es wei- 
ter. Dies ıst ganz praktisch, wenn die Ausgabe zu schnell auf dem Bild- 
schirm erscheint. Man kann alternativ ein Programm anhalten und wieder 
weiterlaufen lassen, so daß man die sich die Ausgabe ansehen kann, bevor 
sie vom Schirm verschwindet. Ein laufendes oder angehaltenes Programm 
kann man durch Control-C abbrechen. 


Jedesmal wenn die Standardeingabe eines Programms der Tastatur zuge- 
wiesen ıst (normaler Zustand), fährt das Programm so lange mit der Ver- 
arbeitung fort, bis ein Control-Z eingegeben wird. Das Control-Z wird als 
Dateiendezeichen interpretiert. Es gibt keine Aufforderung an den Bedie- 
ner, wenn das Programm auf eine Eingabe von der Konsole wartet und die 
Standardeingabe der Konsole zugewiesen wurde; das Programm wartet ein- 
fach auf zu verarbeitende Daten. Der Texteditor ist die einzige Ausnahme 
von dieser Regel. 


Die Datei TOOLS.H 


Während des Kompilierens wird die Datei TOOLS.H in jedes Small-Tools- 
Programm eingebunden. Sie definiert mehrere Systemparameter. Wie schon 
oben erwähnt die Metazeichen. Ebenso die maxımale Größe der Textzeilen 
und die Dimensionen des Bildschirms und des Druckerpapiers. Man kann 
jeden dieser Werte ändern, um ihn an seine eigenen Bedürfnisse anzu- 
passen. Auch sollte man sich diese Datei vor dem Kompilieren ansehen. 
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CHG (Change) 


CHG Muster [Ersatzzeichenkette] 
Beschreibung 


CHG kopiert die Standardeingabe zur Standardausgabe. Bei der Verarbei- 
tung wird der Text nach Mustern durchsucht; jedes gefundenen Vorkom- 
men wird durch eine Zeichenkette ersetzt. 


Das Suchmuster wırd ın der Befehlszeile eingegeben und wırd gemäß den 
oben angegeben Regeln gebildet. Voller Gebrauch der Metazeichen und der 
Escapesequenzen ıst erlaubt. 


Die Ersatzzeichenkette ıst eine beliebige Zeichenkette. Nur zwei Metazei- 
chen haben in ıhr Bedeutung: Circumflex, das für die ganze Zeichenkette 
steht, die mit dem Muster übereinstimmte und der Doppelpunkt, das Es- 
cape-Zeichen. Wenn man einen wirklichen Circumflex oder Doppelpunkt 
braucht, kann man Escapesequenzen verwenden. 


Wenn keine Ersatzzeichenkette angegeben wird, wird eine leere Zeichen- 
kette genommen, das heißt das gefundene Muster wird gelöscht. 


Eın Suchmuster oder dıe Ersatzzeichenkette darf 48 Zeichen nicht über- 
schreiten. Nur die ersten 48 Zeichen von längeren Zeichenketten werden 
verwendet. 


Es ıst gut, vor dem endgültigen Lauf, einen Versuchslauf mit Bildschirm- 
ausgabe zu machen. Wenn man sıch den Effekt vorher ansıeht, kann man 
überprüfen, ob man das Muster und/oder die Ersatzzeichenkette korrekt 
angegeben hat. Man sollte sich daran erinnern, daß man das Programm 
durch aufeinanderfolgende Control-S anhalten und weiıterlaufen lassen und 
durch Control-C abbrechen kann. 


Beispiele 


CHG <ABC eror error 
Kopiert dıe Datei ABC zur Konsole, ändert "eror" nach 
"error." 

CHG <F1 >F2 '[0-9)* 
Kopiert die Dateı Fl nach Dateı F2 und löscht alle führen- 
den numerischen Ziffern aus jeder Zeile. 
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Meldungen 


pattern too long 
Die erweiterte interne Form des Musters ist zu groß, um ın 
den reservierten Speicher zu passen. 

replacement too long 
Die erweiterte interne Form der Ersatzzeichenkette ist zu 
groß, um in den reservierten Speicher zu passen. 
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CNT (Count) 
CNT [Datei] [-C|-W|-L] 
Beschreibung 


CNT durchsucht eine Eıngabedatei und zählt alle Zeichen, Wörter und 
Zeilen. Die Ergebnisse werden auf der Standardausgabe angezeigt. Ein 
Parameter in der Befehlszeile, der kein Schalter ist, wird als Datei genom- 
men, die für die Eingabe geöffnet wird. Wenn kein Dateiname angegeben 
wird, kommt die Eingabe von der Standardeingabe, die umgeleitet werden 
kann. 


Wenn in der Befehlszeile kein Schalter angegeben ist, wird folgendes ausge- 
geben: 


nnnnn characters 
nnnnn words 
nnnnn lines 


wobei nnnnn eine Zahl zwischen O0 und 65535 ist. 


Wenn einer der Schalter angegeben ist, gibt CNT eine einzige Zahl aus, 
entweder die Zahl der gefundenen Zeichen (-C), Wörter (-W), oder Zeilen 
(-L). Wenn mehr als ein Schalter vorhanden ist, wird nur der erste benutzt. 


Die Zeichen Carriage-Return und Line-Feed, die jede Zeile abschließen, 
werden nicht mitgezählt. Um die Anzahl der Bytes in der Datei zu erhal- 
ten, muß man zur Zahl der Zeichen zweimal die Zahl der Zeilen plus ein 
Dateiendebyte addieren (wenn das Ergebnis nicht ein Vielfaches von 128 
Bytes ıst). 


Ein Wort ist als zusammenhängende Zeichenkette druckbarer Zeichen defi- 
niert. 


Beispiele 


CNT <REPORT 
Zeigt auf dem Bildschirm die Anzahl der Zeichen, Wörter 
und Zeilen in der Datei REPORT. 

CNT <FILE >WORDS -W 
Bringt die Zahl der Wörter ın der Datei FILE ın die Datei 
WORDS. | 


Meldungen 


keine 
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CPY (Copy) 
CPY [Datei]... [-.?] [-B] [-NCER] [-NLF) [-T#,#] 
Beschreibung 


CPY ist ein Allzweck-Kopierprogramm. Es kopiert Standard-Small-Tools- 
Dateien genauso wie binäre Dateien, in denen der Dateiinhalt keinen Be- 
schränkungen unterliegt. Wenn man mehr als eine Eingabedatei angibt, 
werden alle Dateien zu einer einzigen Ausgabedateı zusammengefügt. Man 
kann auch angeben, daß alle #include-Anweisungen (in C-Programmen) 
oder .so-Befehle für die Formatierung (in FMT-Textdateien) durch den 
Inhalt der genannten Dateien ersetzt werden. 


Dateien, dıe kopiert werden sollen, werden in der Befehlszeile in der Rei- 
henfolge aufgeführt, in der sie zusammengefügt werden sollen. Wenn keine 
Dateinamen vorhanden sınd, wird die Standardeingabe genommen. Die 
Ausgabe erfolgt immer zur Standardausgabe. 


Wenn #include- und .so-Dateien ın die Ausgabe eingeschlossen werden 
sollen, dann muß der besondere Schalter .? in der Befehlszeile enthalten 
sein. Es ist üblich, Dateinamen mit zwei Teilen anzulegen, dem eigent- 
lichen Namen und einer Erweiterung, die den Datentyp in der Datei be- 
schreibt. Normalerweise werden diese Teile durch eine Punkt getrennt. Das 
Symbol "?" steht für eine Zeichenkette mit keinem oder mehreren der Er- 
weiterung entsprechenden Zeichen, die von den am Kopierprozeß beteilig- 
ten Dateien benutzt werden. Wenn "?" leer ist (nur ein einzelner Punkt),- 
dann werden alle entsprechenden Dateien eingeschlossen. Wenn "?" ein oder 
mehr Zeichen lang ist, dann werden nur die Dateien für die Kopie genom- 
men, die mit der Erweiterung "?" übereinstimmen. 


Der Schalter -B stellt binäre Kopie ein, also eine Byte-für-Byte-Kopie 
ohne eingeschlossene Dateien einzubeziehen und ohne bei einem Dateiende- 
Byte innerhalb der Dateien zu stoppen. Wenn die Eingabe über die Tastatur 
oder über ein I/O-Port kommt, beendet ein Control-Z die Eingabe. Wenn 
der Schalter ".?" bei einer binären Kopie angegeben wird, wird die Mel- 
dung "cannot include files during binary copy" ("Include-Dateien können 
bei binärer Kopie nicht verarbeitet werden") angezeigt und das Programm 
bricht ab. 


Ohne den Schalter -B oder einen der Schalter für eine binäre Kopie, wer- 
den normale Textdateien unterstellt; in diesem Fall ıst die Include-Funktion 
zugelassen und die Kopie einer Eıngabedatei endet, wenn ein Dateiende- 
Byte gefunden wird. 


Small-Tools 109 


Der Schalter -NCR bedeutet "no carriage return" und entfernt ın der Ein- 
gabedatei alle Carriage-Return-Zeichen. Dieser Schalter setzt eine binäre 
Kopie voraus. 


Der Schalter "-NLF" bedeutet "no line-feeds" und entfernt ın der Eingabe- 
datei alle Line-Feed-Zeichen. Dieser Schalter setzt ebenfalls eine binäre 
Kopie voraus. 


Der Schalter -T#,# kann jedes gegebene Zeichen in einer Eingabedatei in 
ein anderes Zeichen übersetzen. Das erste Nummernzeichen steht für den 
dezimalen Wert des zu übersetzenden Zeichens; der zweite für den neuen 
Wert. Dieser Schalter setzt ebenfalls eine binäre Kopie voraus. Der Schalter 
wirkt nach den Schaltern -NCR und -NLF, also werden in Carriage-Re- 
turn oder Line-Feed übersetzte Zeichen nicht umgesetzt. 


Man kann diese drei letzten Schalter benutzen, um fremde Texte zu über- 
setzen. 


Beispiel 


CPY ABC DEF >XYZ 
Schreibt den Inhalt von Datei ABC gefolgt von DEF zur 
Dateı XYZ, und ersetzt alle #include- oder .so-Zeilen mit 
dem Inhalt der genannten Dateien. 


Meldungen 


cannot include files 
Der #include-Schalter wurde zusammen mit einem Schalter 
für eine binäre Kopie angegeben. 
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CPT (Crypt) 
CPT Schlüssel 
Beschreibung 


CPT wird benutzt, um Dateien jeden Typs zu ent- und verschlüsseln. Die 
Eingabe für CPT kommt von der Standardeingabe und die Ausgabe geht 
zur Standardausgabe. 


Ein Begriff, im obigen Befehlsformat als "Schlüssel" bezeichnet, ist immer 
erforderlich. Er kann eine Zeichenkette mit einem oder mehreren Zeichen 
sein (maxımal 80). CPT kombiniert den Begriff mit der Eingabedatei zyk- 
lisch mit einer Exklusiv-ODER-Funktion, um eine Ausgabedatei zu erzeu- 
gen. Die Verarbeitung nimmt keine Rücksicht auf den Zeichensatz oder das 
Dateiende-Byte in Textdateien. Daher kann man jede Dateiart verschlüs- 
seln. 


Wenn einmal eine Datei verschlüsselt wurde, kann man sie wieder ent- 
schlüsseln, indem man sie ein zweites Mal mit dem gleichen Schlüssel ver- 
arbeitet; also erhält man beı zwei Durchläufen mit dem gleichen Schlüssel 
wieder die Ausgangsdatei. Wenn man eine Datei mehrmals mit verschie- 
denen Schlüsseln unterschiedlicher Länge verarbeitet, macht das die De- 
chiffrierung schwieriger. Die Entschlüsselung ist nur eine Frage der Bear- 
beitung der verschlüsselten Dateı mit den gleichen Schlüsseln wie bei der 
Verschlüsselung; die Reihenfolge der Schlüssel ist ohne Bedeutung. 


Dieses Programm ist für die Benutzung von Dateien auf Disketten gedacht; 
es kann jedoch auch mit Daten von der Tastatur oder von einem anderen 
Ein-/Ausgabe-Gerät arbeiten, das an einem Ausgang des Computers ange- 
schlossen ist. In diesen Fällen stoppt die Verarbeitung, wenn ein Control-Z 
gefunden wird. Das Control-Z erscheint nicht in der Ausgabe. Verschlüs- 
selte Daten sind nicht druckbar; man erhält seltsame Ergebnisse auf dem 
Drucker oder dem Bildschirm. 


Beispiele 


CPT <LIST >CLIST MAY 
Verschlüsselt die Datei LIST mit dem Schlüssel MAY zur 
Datei CLIST. 

CPT <CLIST MAY 
Wenn dieser Befehl dem obigen folgt, wird die Datei CLIST 
entschlüsselt und die Ausgabe erfolgt auf dem Bidlschirm. 


Meldungen: keine 
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DTB (Detab) 
DTB [#]... [+#] 


Beschreibung 


DTB wird benutzt, um Tab-Zeichen ın einer normalen Textdatei durch die 
richtige Anzahl von Leerzeichen zu ersetzen, damit die Datei korrekt auf 
Geräten ausgegeben werden kann, die Tab-Zeichen nicht verarbeiten kön- 
nen. Die Eingabe erfolgt über die Standardeingabe, die Ausgabe zur Stan- 
dardausgabe. 


Wenn ın der Befehlszeile keine Parameter vorhanden sind, werden Tabs an 
jeder achten Stelle angenommen, beginnend mit Spalte neun. Wenn diese 
Standard-Annahme nicht korrekt ist, kann man eine List von Zahlen in der 
Befehlszeile angeben. Jede Zahl gibt eine Spalte an, in der ein Tab exi- 
stiert, damit die Eingabe normal auf einem Gerät ausgegeben werden kann, 
das keine Tabs kennt. Man kann der letzten Zahl ein plus Zeichen voran- 
stellen, um anzugeben, daß ein Tab jede angegebene Spalte nach dem letz- 
ten Tab vorhanden sein muß. Wenn dem "+" keine Zahlen ohne Vorzeichen 
vorangehen, ist der erste Tab bei #+1. 


Beispiel 


DTB <SOURCE >LST: 5 +3 
Kopiert die Datei SOURCE, die Tab-Zeichen für ein 
schreibmaschinenähnliches Gerät mit Tabs an Position 5, 8, 
ll und so weiter enthält, zu einem Gerät, das dem logischen 
Gerät LST: zugewiesen ist. 


Meldungen 


tab stop beyond max line length 
Es wurde versucht, ein Tab jenseits der maxımalen Zeilen- 
länge zu definieren. 
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EDT (Edit) 
EDT [Datei] [-V] 
Beschreibung 


EDT ist der Textditor für Small-Tools. Er wird benutzt, um normale Text- 
dateien anzulegen und zu ändern. Wenn in der Befehlszeile eine Datei ge- 
nannt wird, liest EDT diese Datei in den Editierpuffer ein und zeigt die 
ersten Zeilen auf dem Bildschirm. Der Editierpuffer ist leer, wenn keine 
Datei angegeben wird. Ein Nummernzeichen fordert einen Befehl an. 


Wenn in der Befehlszeile der Schalter -v enthalten war, wird der V-Befehl 
vor allem anderen ausgeführt; damit wird nicht mehr automatisch der Puf- 
fer angezeigt. Dies ıst wünschenswert, wenn man EDT in einer SUBMIT- 
Datei benutzt. 


EDT erhält Befehle von der Standardeingabe. Es ist daher möglich eine 
Datei mit Editierbefehlen anzulegen, dann den Editor mit der zu dieser 
Datei umgeleiteten Standardeingabe aufzurufen. Dies ist bei Standard-Edi- 
tierfunktionen praktisch, besonders wenn man den Editor aus einer SUB- 
MIT-Datei aufruft. 


Wenn EDT Zeilen aus dem Puffer anzeigt, wird dıe Ausgabe zur Standard- 
ausgabe geschickt. Man kann diese Ausgabe zu einer Datei oder einem an- 
deren Gerät als dem Bildschirm umleiten. Es gibt jedoch keine vernünfti- 
gen Gründe, die Standardausgabe umzulenken. 


Der Editierpuffer 


EDT ist ein Editor, der im Speicher arbeitet; das bedeutet, daß die gesamte 
Datei in den Speicher des Computers passen muß. Das Editieren verändert 
nur die Kopie der Datei im Speicher; die Datei auf der Diskette bleibt un- 
verändert. Durch einen Schreibbefehl wird der Pufferinhalt auf die Dis- 
kette geschrieben. Dabei wird entweder eine neue Datei angelegt oder eine 
vorhandene ersetzt. 


Da das Programm für die Formatierung von Texten, das Kopierprogramm 
CPY und der Small-C-Compiler Include-Anweisungen unterstützen, kann 
man Dateien, die zu groß für den Speicher sind, in kleinere Teile unter- 
gliedern und sie dann als einzelne Dateien formatieren, kopieren und kom- 
pilieren. 


Jedesmal wenn EDT eıne Zeile im Puffer ändert, wird eine neue Version 
der Zeile angelegt. Die ursprüngliche Zeile wird logisch gelöscht, nimmt 
aber Platz im Puffer weg. Das gleiche gilt auch für gelöschte Zeilen. Aus 
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dıesem Grund kann auch der Puffer überlaufen, wenn die Datei selbst zwar 
in den Puffer paßt, aber eine große Anzahl Änderungen gemacht wurde. In 
der Praxis passıert dies selten, wenn es aber doch einmal vorkommt, be- 
wirkt ein Schreibbefehl eine Reorganisation des Puffers, wobei gelöschte 
Zeilen entfernt werden. 


Zugriff auf Diskettendateien 


Drei Befehle für die Übertragung von Texten zwischen Puffer und Dateien 
auf Diskette sind vorgesehen. Dies sind: 


Befehl Beschreibung 


e [Datei] Datei in Puffer einlesen 
r [Datei] Datei in Puffer dazulesen 
w [Datei] Datei aus dem Puffer schreiben 


Der Enter-Befehl ersetzt den Inhalt des Puffers mit dem der Datei. Vom 
Enter-Befehl unterscheidet sich der Read-Befehl dadurch, daß die Datei an 
einem bestimmten Punkt in den Puffer geladen wird. Der Write-Befehl 
überträgt den Inhalt des Puffers zur Datei. Der gesamte Puffer oder ein 
Teil davon kann zur Datei geschickt werden, aber ın jeden Fall enthält die 
Datei nur den tatsächlich geschriebenen Text. 


Wenn man intensive Editieraufgaben ausführt, sollte man von Zeit zu Zeit 
den Write-Befehl verwenden, um den aktuellen Inhalt des Puffers auf der 
Diskette zu sichern. Wenn man dies nicht macht und der Computer einen 
Stromausfall hat oder man den Editor unbeabsichtigt verläßt, ist der Inhalt 
des Puffers verloren. Wenn man versucht, den Editor zu verlassen (Quit- 
Befehl) aber vergessen hat zur Diskette zu schreiben, erscheint die Warnung 
"diıdn’t write to disk" ("nicht auf die Diskette geschrieben") und man wird 
zu einem anderen Befehl aufgefordert. Ein zweiter Versuch den Editor zu 
verlassen ıst ohne Warnung möglich, auch wenn man vorher nicht zur Dis- 
kette geschrieben hat. Wenn ım Puffer keine Veränderungen vorgenommen 
sind, wird keine Warnung ausgegeben. 


Der Standard-Dateiname 


Der Dateiname beı den Befehlen Enter, Read und Write ıst wahlweise. EDT 
erinnert sich an dıe Datei, mit der gearbeitet wırd. Bei jedem dieser Be- 
fehle ohne Dateiname erinnert sich EDT an die Datei, mit der gearbeitet 
wurde. Dies verringert die Fehlermöglichkeit durch wiederholte Benennung 
der Dateı; ebenso wird auch die Zahl der Eingaben während des Editierens 
verringert. 
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Jedesmal wenn durch Enter eine Datei angegeben wird, wird dies der neue 
Standard-Dateiname. Die bei einem Read- oder Write-Befehl eingegeben 
Dateinamen werden nur dann Standard-Dateinamen, wenn keiner dieser 
drei Befehle seit dem Start des Programms eingegeben wurden. 


Der Dateibefehl File (Datei) kann entweder zum Einstellen oder Anzeigen 
des Standard-Dateinamens benutzt werden. Wenn kein Name vorhanden ist, 
wird einfach der Standard-Dateiname angeziegt. Wenn ein Name da ist, 
wird dieser der neue Standard-Name. 


Die aktuelle Zeile 


Die aktuelle Zeile ıst die Zeile im Puffer, die das Ziel des nächsten Befehls 
ist, wenn der Befehl ohne Zeilennummern angegeben wird. Gewöhnlich 
wird die letzte Zeile, in der ein Befehl ausgeführt wurde, die aktuelle Zeile 
für weitere Befehle. In einigen Fällen wird die veränderte erste Zeile die 
aktuelle Zeile werden. Die Beschreibung jedes Befehls sagt, wie die Posi- 
tıon der aktuellen Zeilen verändert wird. 


Die Kennzeichenspalte 


Die am weitesten links stehende Spalte des Bildschirms wird nicht zum 
Anzeigen von Text benutzt sondern ist reserviert für die aktuelle Zeilen- 
markierung, einen Stern und dem Befehlszeichen (Nummernzeichen). Durch 
die Zeilenmarkierung in der aktuellen Zeile weiß man über seine Position 
im Puffer Bescheid. 


Zeilennummern 


Die meisten Befehle arbeiten mit einer Zeile oder mehreren zusammen- 
hängenden Zeilen. Um die Zielzeilen zu bestimmen, kann man eine oder 
mehrere Zeilennummern unmittelbar vor den Befehl setzen, wenn die Stan- 
dard-Zeilennummern nicht geeignet sınd. Bei Angabe von mehreren Zei- 
lennummern muß man sıe durch Komma oder Semikolon trennen. Bei der 
Benutzung eines Semikolons wird die erste Zahl zur aktuellen Zeile, bevor 
die zweite Zahl ausgewertet wird. Wenn man mehr Zeilen angibt, als vom 
Befehl gebraucht werden, werden die am weitesten rechts stehenden Zahlen 
benutzt. 


Eine Zeilennummer entspricht immer der Position der entsprechenden Zeile 
ım Puffer: Zeile 1 ist immer die erste Zeile ım Puffer, Zeile 253 immer die 
253. Zeile ım Puffer. Dies bedeutet, daß sich die Zeilennummern während 
des Editierens ändern. Wenn zum Beispiel Zeile 25 gelöscht wird, wird aus 
der Zeile 26 die 25, aus 27 wird 26 und so weiter. Wenn eine Zeile vor der 
Zeile 5 eingefügt wird, dann wird aus der Zeile 5 Zeile 6, aus Zeile 6 wird 
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Zeile 7 und so weiter. Dies erweist sich jedoch nicht als schwierig, weil 
man Zeilennumern durch Sonderzeichen und Suchmuster symbolisch ange- 
ben kann. Wirkliche Zeilennummern werden nur selten angegeben. 


Der Zeilenbefehl L zeigt die aktuelle Zeilennummer an, so daß man sie in 
Befehlen verwenden kann. Man kann auch einen Punkt (.) oder einen senk- 
rechten Strich (|) als Zeilennummer angeben. Der Punkt steht für die aktu- 
elle Zeile, der senkrechte Strich für die letzte Zeile im Puffer. 


Eıne Zeilennummer kann auch als durch Schrägstrich und umgekehrten 
Schrägstrich eingeschlossenes Suchmuster angegeben werden. Die Zeilen- 
nummer /abc/ ist die Nummer der ersten Zeile, die der Zeile folgt, die das 
Muster "abc" beinhaltet. Die Zeilennummer \'func()\ ıst die Nummer der 
letzten Zeile, die der Zeile vorausgeht, die das Muster "func()" am Anfang 
der Zeile enthält. 


Man kann Zeilennummern als Summe oder Differenz von Zahlen angeben; 
zum Beispiel gibt .+5 dıe fünfte Zeile nach der aktuellen Zeile an und der 
Ausdruck |-213 gibt die 213. Zeile vor der letzte Zeile an. Der Ausdruck 
/John Doe/-1 ist die Zeile, die der nächsten Zeile vorausgeht, die das 
Muster "John Doe" enthält. Jede Anzahl von Begriffen kann ın einem Zei- 
lenausdruck erscheinen. Wenn der Wert links vom Zeichen + oder - ausge- 
lassen ist, wird "." angenommen. Wenn der Wert rechts fehlt, wird "1" ange- 
nommen. Also sind die folgenden Ausdrücke gültig: 


.+12-5 entspricht .+7 
+5-2-11 entspricht .=8 
.+7+ entspricht .+8 
++++++++ entspricht „+8 
en entspricht „5 


Die folgenden Befehle zeigen die Benutzung von Zeilennummern: 


1,|p Jede Zeile im Puffer drucken. 
1,.d Jede Zeile vom Pufferanfang bis zur aktuellen löschen. 
\'1.\,/'12./Pp 


Alle Zeilen von der vorigen, die "l." am Anfang bis zur 
nächsten, die "12." am Ende enthält, drucken. 
.-2,.+2d Die aktuelle und zwei Zeilen davor und dahinter löschen. 
+23 Die 23. Zeile nach der aktuellen wird die neue aktuelle. 
--- -- Die 5. Zeile vor der aktuellen wird die neue aktuelle. 
jabc/;.-1,.+1d 
Die nächste Zeile, die "abc" enthält finden, sıe zur aktuellen 
machen, sıe und eine Zeile davor und dahinter löschen. 
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Suchmuster 


Befehle kombiniert mit Suchmustern können benutzt werden, um alle oben 
beschriebenen Möglichkeiten anzuwenden. Wenn Suchmuster als Zeilen- 
nummern verwendet werden, kann man nur die Begrenzung / und \ benut- 
zen. Wenn sıe ım Ersetzungsbefehl oder bei den Parametern global oder 
ausgeschlossen erscheinen, wird das erste Zeichen nach dem Befehlsbuch- 
staben (s, g, or x) als Begrenzung benutzt. 


Jedesmal wenn ein Suchmuster angegeben wird, wird es zum aktuellen 
Suchmuster. Auf das Standard-Muster wird durch zweı aufeinanderfol- 
gende Begrenzungszeichen Bezug genommen ("\\" oder "//"). 


Editierbefehle 


In der folgenden Befehlsbeschreibung sind die Zeilennummern in eckigen 
Klammern die Standard-Zeilennummern. Man kann sie durch andere Zei- 
lennummern überschreiben. Wenn bei einem Befehl, der zwei Zeilennum- 
mern benötigt, nur eine angegeben wird, wird diese Zahl auch für die 
zweite genommen. Wenn mehr Zahlen vorhanden sind, als erforderlich 
sind, werden die am weitesten rechts stehenden genommen. 


Der Begriff "angegebene Zeile" ın der Befehlsbeschreibung bezieht sich auf 
die effektive Zeilennummer, ob Standard oder ausdrücklich gegeben, Sym- 
bol (. und |), Suchmuster (zum Beispiel /*abc/) oder aus diesen und den 
arıthmetischen Operatoren (+ oder -) zusammengesetzt. Der Begriff "ange- 
gebene Datei" bezieht sich auf den effektiven Dateinamen, ob Standard 
oder ausdrücklich angegeben. 


In den unten gezeigten Befehlsformaten sind die spitzen Klammern nicht 
Teil des Befehls; sie illustrieren nur die optionalen Befehlsteile. Das Symbol 
<text> steht für keine oder mehrere Textzeilen mit einem Punkt in Spalte 
eins. Das Nummernzeichen zeigt eine dezimale Integer an. 


Die Befehlsbuchstaben können als Groß- oder Kleinbuchstaben geschrieben 
werden. Am Ende eines jeden Befehls kann das Druckbefehl (P) erschei- 
nen. Dies ist ganz nützlich, wenn der Pufferinhalt nicht automatisch ange- 
zeigt wird und man die Auswirkung eines Befehls sehen möchte ohne einen 
zusätzlichen Druckbefehl zu geben. 


Man kann jeden iterativen Befehl, außer Write, durch die Escape-Taste 
abbrechen. Des weiteren kann man die Druck- und Durchsuchbefehle 
durch jeden Tastendruck beenden. (Anhang E zeigt eine Zusammenstellung 
aller Editierbefehle.) 


Beispiele 
[.+1] 


[.]Ja 


<text> 


[351€ 
<text> 


24 1A 


e [file) 


f [file] 


[-Ji 


<text> 
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Dieser Befehl setzt einfach die aktuelle Zeile auf die ange- 
gebene. Wenn keine Zeilennummer vorhanden ist, dann wird 
die der aktuellen Zeile folgende Zeile zur neuen aktuellen. 
Durch Carriage Reiurn bewegt man die aktuelle Zeile um 
eine nach unten - eine bequeme Möglichkeit um sıch 
umzusehen. 

<text> nach der angegeben Zeile anfügen. 

Wenn die Zeilennummer OÖ ist, wird <text> vor die erste 
Zeile im Puffer gesetzt. Jedes Zeichen in <text> wird wie 
eingegeben genommen, Metazeichen und Escape-Sequenzen 
werden nicht erkannt. Zeichen können gelöscht werden, aber 
nur ın der aktuellen Zeile. (BS oder DEL löschen das letzte 
Zeichen und ”X löscht die ganze Zeile.) Um vorhergehende 
Zeilen zu löschen, muß man den Append-Befehl beenden. 
Eine Zeile, die nur einen einzigen Punkt enthält beendet 
<text>, ıst aber kein Teil von <text>. 

Ändert die angegeben Zeilen in <text>. 

Nach Beendigung wird die erste Zeile von <text> die aktu- 
elle. Eine Zeile, die nur einen einzigen Punkt enthält, been- 
det <text>, ıst aber kein Teil von <text>. 

Löscht die angegebenen Zeilen. Die Zeile, die der letzten 
gelöschten folgt, wırd dıe neue aktuelle. Wenn die letzte 
Zeile im Puffer gelöscht wird, wird die letzte übrigbleibende 
Zeile die aktuelle. 

Die angegebene Dateı wird ın den Puffer gelesen. Alles was 
vor dem Befehl ım Puffer vorhanden war, ist verloren. 
Wenn im Puffer Änderungen gemacht worden sind, erscheint 
die Meldung "didn’t write to disk" ("nicht auf Diskette ge- 
schrieben") und der Befehl wird ignoriert. Der zweite Ver- 
such zum Einlesen ist immer erfolgreich. Die erste Zeile im 
Puffer wırd zur neuen aktuellen. 

Einstellen oder Anzeigen des Standard-Dateinamens. Wenn 
ein Dateiname angegeben wird, wird er der neue Standard- 
Dateiname. In jedem Fall wird der Standard-Dateiname an- 
gezeigt. Dieser Befehl zeigt auch die Zahl der noch vorhan- 
denen ungenutzten Bytes im Puffer an. 

<text> vor der angegebenen Zeile einfügen. 

Die letzte Zeile von <text> wırd dıe neue aktuelle Zeile. 
Einfügen unterscheidet sich vom Anfügen nur durch die 
Position von <text>. Eine Zeile, die nur einen einzigen 
Punkt enthält beendet <text>, ıst aber kein Teil von <text>. 
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[.,. mt 


[.,-]P[#] 


Die angegebenen Zeilen zu einer Zeile zusammenfügen. Die 
zusammengefügte Zeile wird die aktuelle. 

Die aktuelle Zeilennummer wird angezeigt. 

Verschiebt die angegeben Zeilen hinter die Zeile #. Die 
letzte verschobene Zeile wird die aktuelle. 

Zeigt die angegebenen Zeilen an. Wenn nur die aktuelle 
Zeile angegeben ist, dann wird auch der Kontext, der die 
angegebene Zeile umgibt, angezeigt. Der Kontext einer Zeile 
besteht aus # Zeilen über und unter ıhr. Der Standard-Kon- 
text ıst 7. Jedesmal wenn # angegeben, wird das der neue 
Standard für zukünftige Ausgaben. Wenn die Konsole ein 
Bildschirm ist, wird dieser erst gelöscht. Die letzte aus- 
gegebene Zeile wird die aktuelle. Wenn die Ausgabe durch 
Escape abgebrochen wird, wird die aktuelle Zeile vom 
Kontextwert abgefangen. 

Editieren beenden. Rückkehr ins Betriebsystem. Wenn im 
Puffer Änderungen vorgenommen waren, erscheint die War- 
nung "didn’t write to disk" ("nicht auf Diskette geschrieben") 
und der Befehl wird ignoriert. Der zweite Versuch zum 
Verlassen des Editors ıst immer erfolgreich. 


[.]r (file) 


Liest die angegebene Datei in den Puffer. Der neue Text 
wird hinter die angegebene Zeile gesetzt. Die letzte gelesene 
Zeile wird die neue aktuelle. Die Zeilennummer 0 kann 
angegeben werden, damit der Text vor der ersten Zeile im 
Puffer erscheint. 


[-,.]5/pat/rep/[9] 


Ersetzt rep durch das erste oder alle pat ın den Zeilen. Wenn 
g (global) hinter dem Befehl erscheint, werden alle Such- 
muster pat ersetzt; sonst wird nur das erste Suchmuster jeder 
Zeile ersetzt. Ein Circumflex (*) in rep ersetzt die ganze 
übereinstimmende Zeichenkette mit dem Suchmuster. Es 
kann beliebig oft vorkommen. Der Befehl "s/abc/*-*-*/" 
ergibt also "abc-abc-abc". Die Escapesequenz ":n" ın der Er- 
satzzeichenkette teilt die Zeile bei jedem dieser Vorkommen 
in separate Zeilen auf. Die letzte geänderte Zeile wir die 
aktuelle. 

Zeigt automatisch die aktuelle Zeile im Kontext an. Stan- 
dardmäßig wird bei jeder Änderung im Puffer oder beim 
Wechseln der aktuellen Zeile, die neue aktuelle Zeile im 
Kontext gezeigt. Diese Vorgehensweise kann durch v ein- 
und ausgeschaltet werden. 
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[1,1]w [file] 
Schreibt die angegeben Zeilen zur angegebenen Datei, Wenn 
die Dateı noch nicht existiert, wird sie angelegt. Wenn sie 
vorhanden ist, wird sie zuerst in eine mit der Erweiterung 
$$$ umbenannt und dann bei erfolgreichem Abschluß ge- 
löscht. Wenn zufällig schon eine Datei mit $$$ existiert, 
wird sıe erhalten und die ursprüngliche Datei wird direkt 
überschrieben. Nach erfolgreichem Abschluß wird die $$$- 
Dateı gelöscht. Bei einem Schreibfehler ist wahrscheinlich 
nocht genug Platz auf der Diskette oder im Verzeichnis. In 
diesen Fällen wird eine Fehlermeldung ausgegeben, der Edi- 
tor läuft weiter und die ursprüngliche Datei mit $$$-Erwei- 
terung bleibt erhalten. 

4:12 Den Editierpuffer anzeigen. Die angegebenen Zeilen werden 
solange am Bildschirm gezeigt, bis eine Taste gedrückt wird. 
Damit kann man sich schnell den Puffer ansehen. 


Bei jedem der oben angegebenen Befehle außer bei Append (anfügen), 
Change (ändern), Insert (einfügen) und Quit (verlassen) können zwei Prä- 
fixe verwendet werden. 


[1l,|]g/pat/command 
Das Präfix global (g) durchsucht die angegebenen Zeilen 
nach dem Suchmuster pat. Jede dieser Zeilen wırd dann zur 
aktuellen und der Befehl (angegeben durch das Wort com- 
mand) wird ausgeführt. Das Suchmuster ım Präfix ist das 
vom Befehl verwndete Standard-Muster. Nach Beendigung 
ist die aktuelle Zeile die, in der die letzte Änderung vorge- 
nommen wurde. 

[1,|]x/pat/command 
Das Außer-Präfix (x) arbeitet genau wıe das Global-Präfix, 
nur das hier die Zeilen, die das Muster nicht enthalten, für 
dıe Verarbeitung ausgewählt werden. 


Die Befehle, die mit dem Präfix global oder außer benutzt werden, können 
wie üblich ihre eigenen Zeilennummern haben; es ist jedoch kein Leer- 
zeichen zwischen der am weitesten rechts stehenden Musterbegrenzung und 
dem Befehl erlaubt. 


Meldungen 


dian't write to disk 
Es wurde versucht, eine Datei einzulesen oder den ganzen 
Puffer zu löschen, bevor die Änderungen im Puffer auf die 
Diskette geschrieben worden sınd. 
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error 
Ein Befehl wurde nicht richtig eingegeben oder eine Zeilen- 


nummer wurde als Suchkriterium eingegeben und die Suche 
blieb ohne Erfolg. 

memory overflow 
Der Editierpuffer im Speicher kann keine weiteren Zeilen 
mehr aufnehmen. Dies ist der Fall, wenn versucht wird, eine 
Datei zu lesen, die zu groß ist oder wenn zu viele Änderun- 
gen ın der Dateı gemacht wurden. 

open error 
Es wurde versucht, mit einem Read- oder Write-Befehl eine 
Datei zu öffnen, die auf der fraglichen Diskette nicht vor- 
handen ist. 


write error 
Während des Schreibens zur Diskette trat ein Fehler auf. 
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ETB 
ETB [#]... (+#] 


Beschreibung 


ETB wird benutzt, um Leerzeichen in einer Standard-Text- 
dateı durch Tabs zu ersetzen. Dies ist genau der umgekehrte 
Effekt von DTB. 

Die Eingabe erfolgt über die Standardeingabe, die Ausgabe 
auf dıe Standardausgabe. 

Wenn ın der Befehlszeile keine Parameter angegeben sind, 
werden Tabs in jeder achten Spalte vermutet, beginnend mit 
Spalte neun. Wenn diese Standard-Annahme nicht korrekt 
ist, kann man eine Liste von Zahlen in der Befehlszeile an- 
geben. Jede Zahl gibt eine Spalte an, ın der ein Tab exi- 
stiert. Man kann der letzten Zahl ein Pluszeichen voran- 
stellen, um anzuzeigen, daß jede x Zeichen nach dem vor- 
herigen Tab ein Tab ıst. Wenn dem + keine Zahlen ohne 
Vorzeichen vorangehen, ist der erste Tab bei #+1l. 


Beispiele 


ETB <ABC >DEF 
Kopiert die Dateı ABC nach DEF, ersetzt aufeinanderfol- 
gende Leerzeichen durch entsprechende Tabs, wobei Tabs an 
jeder achten Stelle angenommen werden, beginnend mit Po- 
sition neun. 

ETB <XYZ >LST: 5 +3 
Kopiert die Datei XYZ zum LST-Gerät, das Tabs an den 
Stellen 5, 8, Il und so weiter hat. 


Meldungen 


tab stop beyond 192 
Es wurde versucht, ein Tab hinter die maxımale Zeilenlänge 
zu setzen. 
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FND 
FND [-]Muster 


Beschreibung 


FND kopiert die Standardeingabe zur Standardausgabe. Dabei wird der 
Text nach Suchmustern durchsucht. Nur Zeilen die das Muster enthalten 
oder nicht enthalten gehen zur Ausgabe; FND wählt also aus einer Datei 
nur die Zeilen aus, die entweder das Suchmuster enthalten oder nicht ent- 
halten. 


Das Suchmuster wird in der Befehlszeile angegeben und wird nach den 
oben beschriebenen Regeln gebildet. Metazeichen und Escapesequenzen 
können vollständig benutzt werden. 


Wenn dem Muster die Tilde (-) vorausgeht, dann werden die Zeilen ausge- 
geben, die das Muster nicht enthalten, sonst werden die Zeilen ausgewählt, 
die das Muster enthalten. 


Beispiele 


FND <ABC '!'[-:s:t] 
Zeigt auf dem Bildschirm alle Zeilen in der Datei ABC, die 
nicht mit einem Leerzeichen oder einem TAB beginnen. 
FND <ABC >DEF -''! 
Kopiert die Datei ABC nach DEF und entfernt alle Leer- 
zeilen. 


Meldungen 


pattern too long 
Die erweiterte interne Form des Musters ist zu groß, um in 
den reservierten Speicher zu passen. 
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FNT 
FNT [Gerät] 


Beschreibung 


Dieses Programm wählt Schriftarten des Drucker aus. In der ausgelieferten 
Version wird aus den Schriftarten des Epson-FX-80 und kompatibler 
Drucker ausgewählt. Es ıst jedoch ein einfaches Programm und kann leicht 
an andere Drucker angepaßt werden. 


Ohne Dateı (oder logischen Gerätenamen) ın der Befehlszeile wird die Aus- 
gabe zum LST-Gerät geschickt. 


FNT zeigt das folgende Menü auf der Standardausgabe an (standardmäßig 
der Bildschirm) und wartet auf eine Eingabe von der Standardeingabe 
(standardmäßig die Tastatur): 


ein aus Modus 

l 2 Schmalschrift 

3 4 doppelter Anschlag 
5 6 Elite 

7 8 hervorgehoben 

9 10 Breitschrift 


11 12 kursiv 

13 14 Pıca 

15 16 tıiefstellen 

17 18 hochstellen 
19 20 proportional 


Eine gültige Antwort wird in die benötigte Control-Sequenz übersetzt und 
das Menü erscheint erneut zur weiteren Auswahl. Eine leere Antwort 
(RETURN) beendet das Programm. Es ist möglich jede Option individuell 
einzustellen und zu löschen. 


Beispiel 


FNT 

Ausgabe zum LST-Gerät. 
FNT PUN: 

Ausgabe zum PUN-Gerät. 


Meldungen: keine 
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FMT (Format) 


FMT [Datendatei] [-Bc#] [-Ec#] [-BP#] [-EP#] 
[-PO#] [-NP] [-NR]J [-T] [-I} [-U] [-S] [-BS#] 


Beschreibung 


FMT ist der Textformatierer der Small-Tools. Textdateien mit eingeschlos- 
senen Befehlen werden druckfertig formatiert. FMT erhält seine Eingabe 
primär von der Standardeingabe. Die Eingabe kann daher auch zur Diskette 
oder Tastatur geleitet werden. Die Ausgabe geht zur Standardausgabe, kann 
also zur Diskette, zum Bildschirm oder zum Drucker umgeleitet werden. 


Man kann auch eine zweite Datei angeben, die Datendateı. In diesem Fall 
wird eine Kopie der primären Eingabedatei für jede Zeile der Datendatei 
erzeugt. Man kann jede Zeile der Datendatei in Felder aufteilen, indem 
man das Begrenzungszeichen (Standard "[") zwischen die Felder setzt, aber 
nicht am Ende einer Zeile. Man kann in der Primärdateı auf diese Felder 
Bezug nehmen, indem man eine Zahl zwischen zwei Begrenzungszeichen 
setzt. Wenn zum Beispiel |3| ın der Primärdatei erscheint, bezieht sich das 
auf das dritte Feld ın der aktuellen Zeile der Datendateı. 


Wenn FMT einen solchen Verweis findet, wird er durch das angegebene 
Feld in der aktuellen Zeile der Datendatei ersetzt. Als Ergebnis erhält man 
eine individuelle Kopie für jede Zeile der Datendatei. Die offensichtliche 
Anwendung einer Datendatei ist die Erstellung von Serienbriefen, andere 
Anwendungen sınd möglich. 


Da es oft notwendig ist, nur einen Teil zu drucken, sind Schalter vor- 
gesehen, die den Beginn und das Ende der Ausgabe kontrollieren. Der 
Schalter -BC12 bedeutet, mit der Kopie 12 zu beginnen; -EC25 bedeutet, 
mit der Kopie 25 aufzuhören. Kopie heißt in diesem Fall vollständige 
Kopien der Primärdatei, eine für jede Zeile ın der Datendatei. Wenn diese 
Schalter ohne Datendatei angegeben werden, dann wird die angegebene 
Zahl der Kopien der Primärdatei erzeugt. In solchen Fällen ist der Schalter 
-BC# nutzlos und kann ausgelassen werden, da der Standard I ıst. Das be- 
wirkt, daß # ım Schalter -EC# die tatsächliche Anzahl der Kopien angibt. 


Der Schalter -BP2 bedeutet, mit der zweiten Seite zu beginnen; -EP112 be- 
deutet, auf Seite 112 aufzuhören. Seite heißt hier formatierte Seite inner- 
halb einer Kopie der Primärdatei. Wenn beide Schalter -BC13 und -BP2 
vorhanden sind, beginnt der Druck auf Seite 2 mit Kopie 13 und geht dann 
für alle Seiten mit entsprechenden Kopien weiter. Wenn die Schalter -EC24 
und -EPI angegeben sind, endet der Druck nach der Seite I von Kopie 24. 
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Ein Seiteneinzug kann in der Befehlszeile angegeben werden. Der Schalter 
-PO5S gibt FMT an, alle ungeraden Seiten fünf Zeichen nach rechts und 
alle geraden Seiten fünf Zeichen nach links zu schieben. Damit kann man 
genug Platz für das Binden lassen, auch wenn das Papier beidseitig be- 
druckt ıst. 


Standardmäßig stoppt FMT vor jeder zu druckenden Seite. Angezeigt wird 
die Meldung "set page # ..." und FMT wartet dann auf eine Antwort, die 
angibt, daß Papier eingespannt und der Drucker bereit ist. Damit kann man 
also ein neues Blatt Papier einlegen. Mit Control-N von der Tastatur geht 
FMT direkt zur nächsten Seite. Auch dabei wird wieder dıe Meldung "set 
page # ..." vor dem Weiterdruck angezeigt. Jede andere Antwort bewirkt, 
daß FMT mit dem Druck begınnt. 


Mit dem Schalter -NP druckt FMT ohne Pause; nach der ersten "ready 
printer ..."-Anzeige, wird ohne Pause zwischen den Seiten gedruckt. Diese 
Option wird beı Endlospapier verwendet. Mit dem Schalter -NR übergeht 
FMT die Ready-Meldung. Das ıst nützlich, wenn FMT in einer SUBMIT- 
Datei ohne Unterbrechung verwendet wird. 


Es gibt zwei Arten um Unterstreichung, Doppeldruck und Kursivdruck zu 
kontrollieren. Das ist einmal der Epson-Modus und zum anderen der TTY- 
Modus (nicht-intelligenter Drucker). Im Epson-Modus (standardmäßig) 
werden Steuerzeichensequenzen zum Drucker geschickt, damit mit einem 
Minimum an Kopfbewegungen unterstrichen, halbfett oder kursiv gedruckt 
werden kann. Drucken mit doppelter Breite ıst auch möglich. Im TTY-Mo- 
dus (spezifiziert durch den Schalter -T) wird durch mehrere Anschläge 
unterstrichen und halbfett gedruckt. Drucken in doppelter Breite oder kur- 
siv ıst überhaupt nicht möglich. 


Mit dem Schalter -I erreicht man, daß unterstreichen als kursiv inter- 
pretiert wird. 


Mit dem Schalter -U erreicht man, daß kursiv als unterstrichen interpre- 
tiert wird. 


Mit dem Schalter -S erreicht man, daß FMT in der Ausgabe die Namen 
der Dateien anzeigt, dıe ım Befehl ".so file" angegeben sınd. Damit kann 
man die Dateigrenzen ın längeren Ausdrucken besser ıdentifizieren. 


Im TTY-Modus gibt der Schalter -BS# die Zahl der Standardanschläge für 
Fettdruck an. # ıst die Anzahl der zu verwendenden Anschläge. 
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Befehle 


Befehle, die FMT sagen, was zu tun ist, werden im zu verarbeitenden Text 
eingeschlossen. Jede Zeile, die mit einem Punkt (oder einem anderen ange- 
geben Zeichen) beginnt, wırd als Befehl interpretiert. Jeder Befehl besteht 
aus zwei Buchstaben, dıe dem Punkt sofort folgen. Die Buchstaben sind 
nach mnemonischen Gesichtspunkten gewählt worden und können daher 
sehr leicht behalten werden. 


Die meisten Befehle haben noch numerische oder Zeichenparameter in der 
gleichen Zeile. Ein oder mehrere Leerzeichen trennen die Befehle von 
ihren Werten. Befehle können in Klein- oder Großbuchstaben angegeben 
werden. 


Anstelle eines Punktes kann das Befehlskennzeichnen auch ein anderes 
Zeichen sein, wenn man den Befehl .cc ? eingibt, wobeı das ? das neue 
Befehlskennzeichen ist. Man kann den Befehl ?cc . eingeben, um wieder 
den Punkt als Befehlskennzeichen zu haben. Durch Änderung des Befehls- 
flags kann man Text mit führenden Punkten ın den Zeilen verarbeiten. 


Jeder Befehl, der einen numerischen Wert braucht, akzeptiert diesen abso- 
lut oder relativ. Wenn eine Zahl ohne Vorzeichen angegeben wird, wird sie 
als neuer Wert interpretiert. Wenn der Zahl ein Minus oder Plus voraus- 
geht, dann wird diese Zahl zum derzeitig wirksamen Wert addiert oder 
subtrahiert und man erhält dann den neuen Wert. 


Wenn zum Beispiel ein Textabschnitt vier Stellen eingerückt und danach 
dann wieder normal weitergemacht werden soll, kann man angeben: 

.in +4 

(Text) 

(Text) 

(Text) 

‚in -4 
Durch diese Anordnung kann man lokal Änderungen in der Formatierung 
machen ohne auf den Gesamttext Rücksicht nehmen zu müssen. Allgemeine 
Befehle kann man an den Anfang der Dateı stellen, wo man sie leicht fiın- 
den und ändern kann. Zum Beispiel sollte man nicht die ganze Datei nach 
jedem Vorkommen eines Befehls zu durchsuchen haben, wenn man eine 
vorhandene Dateı mit anderen Randabständen drucken will. 
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Das Layout einer Seite 


Die durch FMT erzeugten Seiten haben das in der folgenden Abbildung 
gezeigte Format. 


xxxxxx Kopfzeile xxxXxX I..uoonen.e 


KAXXKXKXKXKXKXKAKXKKKK 
XXXAXKXXKAXKXKAXKXKXXKX . 2 
KXXXKXKXKXKKKKXKXKKIKX Seitenlänge 
KXXXXXXX TEXT XXXXXXXX (66 Zeilen) 
KXXKKKXXXXKXXXKAXKXKKKXK : 
KXXXKXKXKAXKXAXAKXKXXKK 

KAXXKXKXKAXKKAKXKXKKXK Iaeaeuonnn. 


xxxxıı Fußzeile xxxxxX Rand 4 65 Zeilen) 


rechter Rand (Spalte 74) 
Linker Rand (Spalte 11) 


Die Dimensionen einer Seite sınd in Zeilen (horizontal) oder Spalten 
(vertikal) angegeben. Jede Angabe wird mit den Standardwerten in Klam- 
mern gezeigt. 


Der Abstand am Seitenanfang und Seitenende ist jeweils 5 Zeilen breit. 
Dies ist der effektive Abstand; der tatsächliche Standardabstand für Rand | 
und 4 ıst 1 bzw. 9. Die Ränder entsprechen dem Seitenformat, wenn das 
Papier so ım Drucker eingespannt wird, daß die erste Druckzeile, Rand I, 
etwa vier Zeilen vom Seitenanfang beginnt. Dies ist die normale Papier- 
position für den Seitenanfang ın einem Drucker. 


Wenn man Endlospapier benutzt, sollte man den Schalter -NP setzen. In 
diesem Fall wird keine Pause zwischen den Seiten gemacht. Der Rand am 
Ende der Seite überspringt die Perforation zwischen den Seiten und läßt am 
Anfang und am Ende einer Seite gleichviel Platz. 


Wenn man Einzelblattpapıer benutzt, muß man sie einzeln in den Drucker 
einspannen und sollte den Schalter -NP nicht angeben. In diesem Fall 
macht FMT eine Pause zwischen den Seiten und wartet auf das nächste 
Blatt. Die Pause erfolgt sofort nach Drucken der Fußzeile. Der Druck geht 
sofort mit der Kopfzeile der nächsten Seite weiter. Also liegt es in je- 
dermanns eigener Verantwortung, dafür zu sorgen, daß die gedruckte Seite 
entfernt und die neue genau da eingespannt wird, wo weitergedruckt wer- 
den soll. 
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Mit den folgenden Befehlen kann man das Standard-Layout einer Seite än- 
dern: 


.ml # Rand | 

.m2 # Rand 2 

.m3 # Rand 3 

.m4 # Rand 4 

.pl # Seitenlänge 

.lm # linker Rand 
.rm # rechter Rand 


Diese Befehle können irgendwo im Text stehen und sie werden an dieser 
Stelle wirksam. Üblicherweise setzt man sie an den Dateianfang und läßt 
sie dann unverändert stehen. 


Wenn man die Seitenlänge Null angibt (.pl 0), dann wird der Text als eine 
Seite von unendlicher Länge betrachtet. Dabei wird normal formatiert, es 
gibt nur keine Seitenunterbrechung und keine Fuß- und Kopfzeilen. Nütz- 
lich ıst diese Formatierung zur Eingabe für andere Programme. 


Kopf- und Fußzeilen 


Kopf- und Fußzeilen sind optional. Sofern man sie nicht explizit angibt, 
erscheinen sie als Leerzeilen innerhalb von Rand I und Rand 4. Einmal an- 
gegeben erscheinen diese Zeilen automatisch an der richtigen Stelle auf je- 
der Seite. Dies bleibt bis zur Neudefinition wirksam. Fußzeilen beginnen 
auf der aktuellen, Kopfzeilen auf der folgenden Seite. 


Nur eine Zeile wird für Kopf- oder Fußzeile benutzt. Die Kopfzeile er- 
scheint als letzte Zeile von Rand I, die Fußzeile als erste Zeile von Rand 4. 
Diese Ränder müssen daher wenigstens eine Zeile umfassen, damit Kopf- 
und Fußzeilen erscheinen können. 


Der Befehl .he [Text] wird benutzt, um eine Kopfzeile mit dem Text zu 
definieren, der dem Befehl folgt. Der Befehl .fo [Text] definiert genauso 
eine Fußzeile. Wenn kein Text angegeben wird, erscheint eine leere Kopf- 
oder Fußzeile. Mit FMT kann man unterschiedliche Kopf- und Fußzeilen 
für gerade und ungerade Seiten definieren. Es gibt sechs Befehle: 


.he [Text] Kopfzeile 

‚oh [Text] Kopfzeile auf ungerader Seite 
.eh [Text] Kopfzeile auf gerader Seite 
.fo [Text] Fußzeile 

.of [Text] Fußzeile auf ungerader Seite 
.ef [Text] Fußzeile auf gerader Seite 
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Es gibt zwei Zeichen mit besonderer Bedeutung innerhalb von Kopf- und 
Fußzeilen. Das Nummernzeichen # steht für die aktuelle Seitenzahl. Jedes- 
mal wenn es ın Kopf- oder Fußzeile erscheint, wird es durch die aktuelle 
Seitenzahl ersetzt. Den Schrägstrich / kann man verwenden, damit der Text 
gleichmäßig zwischen den Rändern verteilt erscheint. Die Schrägstriche 
werden so durch Leerzeichen ersetzt, daß das erste Zeichen auf dem lınken 
Rand, das letzte Zeichen auf dem rechten Rand steht. Durch umsichtige 
Benutzung von Schrägstrichen kann man Text zentrieren, Text dehnen und 
Text einseitig ausrichten. 


Durch den Befehl "fo /- # -/" erhält man eine zentrierte Fußzeile mit von 
Bindestrichen umgebener Seitenzahl. 


Zeilen füllen und Blocksatz 


Wenn nicht anders angegeben, gibt FMT keine Zeile im Text aus, so lange 
nicht genug Wörter da sind, um die Zeile zu füllen; Wörter werden also 
zuerst in einer Zeile gesammelt, bis zu dem Wort, daß den rechten Rand 
überschreiten würde. Dieses Wort bleibt gespeichert und erscheint als erstes 
ın der nächsten Zeile. Dieses Verfahren wird als Zeilenfüllen bezeichnet. 
Dies kann durch den Befehel .nf (nicht füllen) abgeschaltet und durch den 
Befehl .fi (füllen) wieder eingeschaltet werden. Wenn FMT zusammenhän- 
gende Leerzeichen entdeckt, werden alle außer dem ersten ignoriert. Zwei 
Leerzeichen werden hinter den Punkt gesetzt, der einen Satz beendet. 


FMT fügt automatisch Leerzeichen so zwischen Wörter in einer Zeile ein, 
daß das letzte Zeichen des letzten Wortes genau auf dem rechten Rand 
steht. Dies bezeichnet man als Blocksatz. Durch den Befehl .nj läßt sıch 
dies ausschalten, durch .ju wieder einschalten. 


Manchmal ıst es wichtig, daß eine bestimmte Anzahl von Leerzeichen an 
einer gegebenen Stelle ın einer Zeile erscheinen. Der Blocksatz und das 
Zeilenfüllen sollten nichts daran ändern. Für die zusätzliche Kontrolle 
dieser Umstände ist die Tılde (-) vorgesehen, die ein Pseudo-Leerzeichen 
darstellt. Es wird wıe jedes andere Zeichen beı der Ausrichtung und beim 
Zeilenfüllen behandelt, wird jedoch vor der Ausgabe in ein Leerzeichen 
umgewandelt. 


Wenn die Tilde als Tilde erscheinen muß, kann man ein anderes Zeichen 
als Pseudo-Leerzeichen definieren und zwar durch den Befehl .sc x. Dabeı 
wird x jetzt das Pseudo-Leerzeichen und der Befehl .bc - gibt der Tilde 
ihren Ausgangsstatus zurück. 
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Zeilenunterbrechung 


Unter gewissen Bedingungen während FMT Zeilen füllt, kann eine Zeile 
gedruckt werden, die noch nicht voll ıst. Dies bezeichnet man als Zeilen- 
unterbrechung. In diesen Fällen gibt es keinen Blocksatz, das heißt alle 
Leerzeichen erscheinen rechts der Zeile. 


Eine Ursache für die Zeilenunterbrechung ist eine Leerzeile im Text. Wenn 
FMT auf eine Leerzeile trifft, wird die aktuelle Zeile so ausgegeben wie 
sie ist und dann die Leerzeile gedruckt. Dies ist eine einfache Möglichkeit 
Text in Absätze zu gliedern, getrennt durch zwei Leerzeilen. 


Bestimmte Befehle bewirken eine Zeilenunterbrechung; dies sınd: 


TI füllen 

.nf nicht füllen 

.Ju Blocksatz 

N] kein Blocksatz 

.br Unterbrechung 

.sp # # Leerzeilen 

.bp # neue Seite 

.in # um # Stellen einrücken 

.iIm # linken Rand auf # setzen 

.ti # zeitweise um # Stellen einrücken 
.ce # die nächsten # Zeilen zentrieren 
.sq # Ränder um # Stellen zusammendrücken 
.ne # # Zeilen zusammenhalten 


Die letzte Ursache für eine Zeilenunterbrechung ist eine Zeile mit einem 
oder mehreren führenden Leerzeichen. Eine solche Zeile wird mit den 
Leerzeichen ausgegeben; wenn Zeilenfüllen und Blocksatz eingeschaltet 
sind, werden sie auf die Zeile angewendet. 


Seitenunterbrechung 


Während FMT Text verarbeitet, wird die Anzahl der Zeilen, die schon auf 
der Seite stehen, gespeichert. Wenn keine Zeilen mehr hineinpassen, werden 
Rand 3 und 4, möglicherweise mit einer Fußzeile, ausgegeben und eine 
neue Seite beginnt. Wenn FMT zwischen den Seiten stoppt (Normalfall) 
hört man den Lautsprecher und sieht die Meldung "set page # ..." wobei # 
die neue Seitenzahl angibt. In diesem Fall werden die der Fußzeile folgen- 
den Zeilen von Rand 4 nicht gedruckt. Dies verhindert, daß die Kante am 
Ende der Seite über den Druckmechanismus schleift und sich vielleicht in 
die bewegten Teile verklemmt. 
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Bei fortlaufendem Druck beginnt FMT sofort ohne Unterbrechung mit der 
nächsten Seite. 


Seitenunterbrechungen können an jeder Stelle ım Text durch den Befehl .bp 
# bewirkt werden. Wenn ım Befehl eine Zahl erscheint, wird diese Zahl die 
neue Seitenzahl; sonst erhält die neue Seite eine um eins größere Seitenzahl 
als die vorherige. 


Die Seitenzahl hat drei Bedeutungen. Erstens kann sıe in Kopf- und Fuß- 
zeilen gedruckt werden, zweitens gibt sie die Richtung des Seitenoffsets 
(.po) an. Drittens kann damit die Stelle im Text angegeben werden, an der 
der Druck beginnt oder endet. 


Einrücken 


Einrücken kann man, wenn man eine Anzahl Leerzeichen zum linken Rand 
hinzufügt oder von ıhm entfernt. Der Standardwert ist Null. Man kann den 
Befehl .in # benutzen, um die Einrückung aller folgenden Zeilen fest- 
zulegen. Der Befehl .ti # wirkt nur temporär auf die folgende Zeile. Dies 
ist ganz praktisch für die Einrückung von Absätzen. In beiden Befehlen ist 
der Standardwert für # Null. 


Eine Sonderform des Einrückens bewirkt der Befehl .sg #. Dabeı rückt 
FMT von beiden Rändern um # Stellen nach innen. Dies ist sinnvoll, wenn 
man Zitate hervorheben will. Der Standard-Wert für # ist Null. Diese 
Druckform wird solange beibehalten, bis ein .sgqg oder .sqg 0 gefunden wird. 
Am linken Rand werden die aktuellen und die temporären Werte zum Wert 
des Befehls .sg addıert. Durch ein Pluszeichen kann der aktuelle Wert von 
.sq um # erhöht, durch ein Minuszeichen vermindert werden. 


Zentrieren 


Durch den Befehl .ce # werden die nächsten # Zeilen im Text zentriert. 
der Standardwert für # ıst 1, also zentriert .ce nur die folgende Zeile. Der 
Befehl .ce 0 stoppt die Zentrierung; dies ıst praktisch, wenn eine unbe- 
stimmte Zeilenzahl zentriert werden soll. Zuerst gibt man .ce 1000 an (oder 
irgendeine Zahl größer als benötigt, aber nicht größer als 32767), gefolgt 
von dem zu zentrierenden Text; am Ende erscheint der Befehl .ce 0. 


Die Zentrierung erfolgt zwischen dem linken und rechten Rand; die Eın- 
rückungswerte wirken sıch nicht aus. 
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Unterstreichen 


Text kann durch einen der beiden vorhandenen Befehle unterstrichen wer- 
den. Durch .ul # werden die nächsten # Zeilen unterstrichen, Leerzeichen 
zwischen den Wörtern werden nicht unterstrichen. Mit dem Befehl .cu # 
wird fortlaufend unterstrichen, also auch die Wortzwischenräume. Sonder- 
zeichen werden normal nicht unterstrichen; das fortlaufende Unterstreichen 
unterstreicht jedoch auch eckige, geschweifte, runde Klammern und Semi- 
kolons. 


Die Befehle .ul und .cu schließen sich wechselseitig aus. Wenn einer gege- 
ben wırd, während der andere noch wirksam ist, wird dessen Wirkung aus- 
geschaltet. 


Genau wie bei der Zentrierung können auch hier beliebig viele Zeilen 
durch einen entsprechend hohen Wert für .ul # oder .cu # unterstrichen 
werden. Nach dem Text kann man dann durch .ul 0 oder .cu O0 das Unter- 
streichen wieder beenden. Eine andere Möglichkeit der Beendigung erhält 
man durch den Befehl .nu (nicht unterstreichen). Jeder dieser drei Befehle 
kann jede Art des Unterstreichens beenden. 


FMT arbeitet beim Unterstreichen, im Kursivdruck und Doppeldruck ın 
einem von zwei Modi. Im Epson-Modus (Standard) wird dadurch unter- 
strichen, daß die korrekten Kontrollzeichen vor und hinter den zu unter- 
streichenden Zeichen erzeugt werden; der Drucker (Epson oder ein anderer 
Nadeldrucker) unterstreicht dann während des Druckens. Im Teletype-Mo- 
dus (Schalter -t) erreicht man unterstreichen dadurch, daß jedem zu unter- 
streichenden Zeichen eine Sequenz aus Unterstrich und Backspace voran- 
gestellt wırd. Abhängig vom vorhandenen Druckmechanismus kann dieser 
Modus sehr langsam sein und man erhält eine abgehackte Hın- und Herbe- 
wegung des Druckkopfes. 


Der Kommentar-Befehl 


Der Befehl .Text bewirkt, daß der Text auf dem Bildschirm angezeigt 
wird, wenn das Programm ihn findet. Zuerst ertönt der Lautsprecher, dann 
erscheint auf dem Bildschirm das Wort note, gefolgt von dem entsprechen- 
den Text. Diese Kommentarzeile wird bei der Formatierung nicht berück- 
sichtigt. Man kann dem Bediener damit besondere Anweisungen geben, wie 
er den Text zu behandeln hat. Zum Beispiel kann man einen Kommentar 
ans Ende des Textes stellen und dem Bediener sagen, was er als nächstes zu 
tun hat. 
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Fehlerhafte Befehle 


Fehlerhafte Befehle werden als Kommentar behandelt. Der Lautsprecher 
ertönt und sie erscheinen auf dem Bildschirm als Kommentar, werden aber 
für die Textformatierung ignoriert. Dies zeigt dem Bediener, daß etwas 
falsch ist und zeigt die in Frage kommende Zeile. Dies geschieht, wenn 
beim zu formatierenden Text ein Befehlskennzeichen (gewöhnlich ein 
Punkt) in der ersten Spalte der Zeile steht. 


Bediener- Aufforderung 


Durch den Befehl .pr wırd der Bediener aufgefordert, Informationen von 
Hand an einer Stelle im Text einzugeben. Der Lautsprecher ertönt, zeigt 
dann das Wort enter: gefolgt vom Text ım Befehl. Wenn zum Beispiel der 
Bediener manuell das Datum für einen Brief eingeben muß, könnte man 
den Befehl .pr Datum an der Stelle ım Text einfügen, an der das Datum 
erscheinen soll. Es muß, wie alle Befehle zur Formatierung, in einer eige- 
nen Zeile stehen. Wenn dieser Befehl gefunden wird, hört der Bediener den 
Lautsprecher und sieht "enter: Datum" an der Konsole. 


An dieser Stelle erwartet das Programm Eingaben von der Tastatur. Dieser 
Text wırd genauso verarbeitet, als wäre er schon in der Datei vorhanden. 
Die Eıngabe wird, wie beim Texteditor, durch eine Zeile, die nur einen 
Punkt enthält, abgeschlossen. Im obigen Fall wäre nur eine Zeile not- 
wendig. Dieser würde eine Endezeile folgen. Der abschließende Punkt wird 
bei der Textformatierung nicht berücksichtigt. 


So können Befehle zur Formatierung auch manuell eingegeben werden. Das 
letzte Zeichen in der aktuellen Eingabezeile kann man durch DEL oder 
Backspace löschen; Control-X löscht die gesamte Zeile. 


Text aus anderen Quellen 


Oft ıst es bequem Textteile anzulegen und zu speichern, die man später in 
verschiedenen anderen Texten wieder verwenden kann. Dies ist möglich, 
wenn man den Text zuerst mit dem Texteditor erfaßt und ihn dann auf 
Diskette speichert. In der Datei, ın der der Text erscheinen soll, gibt man 
an geeigneter Stelle den Befehl .so Datei, worauf FMT die genannte Datei 
an diesem Punkt in den Text kopieren wird. Dieser Befehl entspricht dem 
Aufforderungsbefehl, nur daß der Text hier nicht von der Tastatur sondern 
aus einer Dateı kommt. 


Der Befehl .so ıst praktisch, wenn man Texte benötigt, die zu großen Tei- 
len aus einzelnen Textbausteinen bestehen. Der Text in der Dateı wiederum 
kann auch Befehle zur Formatierung oder zur manuellen Eingabe enthalten. 
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Zeilenabstand 


Standardmäßig erzeugt FMT eine einzeilige Ausgabe. Dies kann durch den 
Befehl ./s # in einen Abstand von # Zeilen geändert werden. Ein Wert von 
2 gibt doppelten Abstand, also eine Leerzeile zwischen den gedruckten 
Zeilen. 


Gelegentlich sind zusätzliche Leerzeilen an ausgewählten Stellen im Text 
erwünscht. Dafür kann der Befehl .sp # benutzt werden. Der Befehl .sp 1/1 
bewirkt eine Zeilenunterbrechung gefolgt von 11 Leerzeilen. 


Eine andere Möglichkeit ist, 11 Leerzeilen in den Text einzugeben. Dieser 
Ansatz ıst jedoch nicht empfehlenswert, wenn mehr als eine Zeile benötigt 
wird, weil es nicht immer ganz einfach ıst, vom Bildschirm auf die wirk- 
lich erzeugte Zahl der Zeilen zu schließen. Sechs Leerzeilen sehen fast ge- 
nauso wie fünf aus. 


Text zusammenhalten 


Es gibt zwei Methoden, um zu verhindern, daß Text auf verschiedenen 
Seiten erscheint. Manchmal muß eine Tabelle auf einer einzigen Seite er- 
scheinen. Um das zu garantieren, muß der Befehl .ne # verwendet werden, 
der besagt, daß für den folgenden Text # Zeilen gebraucht werden. Wenn 
auf der aktuellen Seite noch genug Platz ist, wird nichts unternommen. 
Wenn dagegen nicht genügend Platz vorhanden ist, erzwingt FMT einen 
Seitenvorschub und der folgende Text erscheint auf der neuen Seite. 


Die zweite Methode vermeidet einzelne Zeilen am Ende einer Seite. Der 
Befehl für die kleinste Absatzlänge (.mp #) bestimmt die minimale Anzahl 
von Zeilen, die auf einer Seite sein müssen, bevor ein neuer Absatz ge- 
druckt wird. Wenn nicht genug Platz vorhanden ist, beginnt eine neue 
Seite. Der Standardwert ıst 2, der an jeder Stelle geändert werden kann. 


FMT hat keine Möglichkeit, einzelne Zeilen am Beginn einer Seite zu 
verhindern. Man kann den Text prüfen und dann für diesen Zweck den 
Befehl .ne # einfügen. 


Befehle zur Formatierung 


Befehle zur Formatierung erscheinen im zu verarbeitenden Text. Jeder 
steht für sich auf einer einzigen Zeile. Befehle können in Groß- oder 
Kleinbuchstaben angegeben werden. 


Die eckigen Klammern, dıe ın der folgenden Befehlsübersicht erscheinen, 
sind nicht Teil der Befehle; sie zeigen nur an, daß das eingeschlossenen 
Feld optional ıst. Nummernzeichen stehen für Zahlen zwischen 0 und 
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32767. Jedem numerischen Wert kann ein Plus- oder Minuszeichen voraus- 
gehen. Die Wirkung eines Vorzeichens besteht darin, das die Zahl als Än- 
derung einer schon bestehenden und nicht als neuer absoluter Wert inter- 
pretiert wird. Zum Beispiel bedeutet ./m 5, daß der linke Rand auf Spalte 5 
gesetzt wird; .Im +5 bedeutet, daß der linke Rand 5 Stellen nach rechts ge- 
bracht wırd. Das Fragezeichen steht für jedes druckbare Zeichen. Die 
Wörter Text und Datei sınd Platzhalter, die eine Textzeile oder eınen 
Dateinamen bezeichnen. 


Die Befehle zur Formatierung folgen in alphabetischer Ordnung: 


„DE 7 


.bf 


.bp 


.br 


.CC 


.ce 


.‚cu 


. Aw 


[(#] 


[(#) 


[(#) 


[(#] 


Pseudo-Leerzeichen einstellen 

Benutzt ? für ein neues Pseudo-Leerzeichen. Vorkommen 
von ? werden ım Text beim Zeilenfüllen und beim Blocksatz 
nicht als Leerzeichen behandelt, werden aber vor der Aus- 
gabe ın Leerzeichen umgewandelt. 

Fett- oder Doppeldruck 

Druckt die nächsten # Zeilen fett oder doppelt. Der Stan- 
dardwert für # ıst 1. .bf 0 beendet den Fettdruck. 

Neue Seite beginnen 

Erzwingt Seitenvorschub. Wenn eine Zahl angegeben ist, be- 
stimmt sie die neue Seitenzahl; sonst wird die aktuelle 
Seitenzahl um I erhöht. 

Neue Zeile beginnen 

Erzwingt Zeilenvorschub. Die aktuelle Zeile wird ohne 
Blocksatz gedruckt und eine neue Zeile beginnt. 
Befehlszeichen einstellen 

Verwendet zukünftig ? als Zeichen für Befehle. Den folgen- 
den Befehlen muß anstatt des üblichen Punktes ein ? vor- 
ausgehen . 

Zentrieren 

Erzwingt eine neue Zeile und bewirkt, daß die nächsten # 
Zeilen zentriert gedruckt werden. Der Standardwert für # ıst 
1. 

Durchgehend unterstreichen 

Unterstreicht die folgenden # Zeilen inklusive der Leer- 
zeichen. Wenn # Null ist, wird das Unterstreichen beendet. 
Der Standardwert für # ıst 1. 

Doppelt breite Zeichen 

Drucke die nächsten # Zeilen in doppelter Breite. Der Stan- 
dardwert für # ıst 1. Der Befehl .dw 0 beendet das Drucken 
in doppelter Breite. Ist nur im Epson-Modus wirksam. 
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.ef [Text] Fußzeile für gerade Seiten 


‚eh 


.fi 


.fo 


.he 


‚in 


Lt 


.JU 


Text wird als Fußzeile auf jeder geraden Seite benutzt, be- 
ginnend mit der nächsten. Wenn kein Text vorhanden ist, ist 
die Fußzeile leer, es wird also eine Leerzeile gedruckt. 


[Text] Kopfzeile für gerade Seiten 


Text wird als Kopfzeile auf jeder geraden Seite benutzt, be- 
ginnend mit der nächsten. Wenn kein Text vorhanden ist, ist 
die Kopfzeile leer, es wird also eine Leerzeile gedruckt. 
Zeilen füllen 

Erzwingt eine neue Zeile und beginnt die nächste Zeile mit 
Text zu füllen. Zeilenfüllen ist der Standardmodus, also 
kann dieser Befehl den Modus wieder setzen, wenn er zuvor 
beendet wurde. 


[Text) Fußzeile 


Text wird als Fußzeile auf jeder der folgenden Seite be- 
nutzt, beginnend mit der aktuellen. Wenn keın Text vorhan- 
den ist, wird die Fußzeile unterdrückt, beginnend mit der 
aktuellen. Unterdrückte Fußzeilen erscheinen als Leerzeilen. 


[Text] Kopfzeile 


[(#] 


Text wird als Kopfzeile auf jeder der folgenden Seiten be- 
nutzt, beginnend mit der aktuellen. Wenn kein Text vorhan- 
den ist, wird die Kopfzeile unterdrückt, beginnend mit der 
aktuellen. Unterdrückte Kopfzeilen erscheinen als Leerzei- 
len. 

Einrücken 

Erzwingt eine neue Zeile und rückt dann den folgenden 
Text um # Stellen nach rechts ein. Wenn # ein Vorzeichen 
hat, wird der aktuelle Wert um den angegeben Wert unter 
Berücksichtigung des Vorzeichens geändert (minus nach 
links, plus nach rechts). Wenn der Wert negativ wird, be- 
ginnt der Druck vor dem linken Rand. Der Standardwert 
von # ıst O. 

Kursiv 

Die nächsten # Zeilen werden kursiv gedruckt. Der Stan- 
dardwert für # ıst I. Der Befehl .it O0 beendet den Kursiv- 
druck. Im TTY-Modus wird dieser Befehl ignoriert (wenn 
nicht der Schalter -u ein Unterstreichen bewirkt). 

Blocksatz 

Erzwingt eine neue Zeile und beginnt mit dem Blocksatz ın 
der folgenden Zeile. Da dieser Modus Standard ist, würde 
dieser Befehl den Modus wieder einstellen, nachdem er ab- 
geschaltet war. 


.lm 


.1s 


ml 


.Mm2 


.m3 


.m4 


.MC 


.mp 


.ne 


.nf 


[(#] 


[#] 


[#) 


[(*] 


[#] 


[(#) 


.‚ 


[#] 


[#) 
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linker Rand 

Erzwingt eine neue Zeile und verwendet dann # als neuen 
Wert für den linken Rand. Der linke Rand ist die Spalte, ın 
der das erste Zeichen erscheint, wenn nicht eingerückt wird. 
Der Standardwert für # ıst 11. 

Zeilenabstand 

Benutzt # als neuen Wert für den Zeilenabstand. Der Stan- 
dardwert für # ıst 1. 

Rand | 

Benutzt # als Zahl der Zeilen ın Rand I. Der Standardwert 
für # ist 1. Dieser Befehl sollte .p/! # vorausgehen. 

Rand 2 

Benutzt # als Zahl der Zeilen in Rand 2, dem Rand zwi- 
schen Rand I und dem eigentlichen Text. Der Standardwert 
für # ıst 2. Dieser Befehl sollte .p! # vorausgehen. 

Rand 3 

Benutzt # als Zahl der Zeilen ın Rand 3, dem Rand zwi- 
schen Rand 1 und dem eigentlichen Text. Der Standardwert 
für # ist 2. Dieser Befehl sollte .p! # vorausgehen. 

Rand 4 

Benutzt # als Zahl der Zeilen in Rand 4, dem Rand am 
Ende. Der Standardwert für # ıst 9. Dieser Befehl sollte .p/ 
# vorausgehen. 

Feldtrennzeichen ın Datendateien 

Verwendet ? als Trennzeichen in den Zeilen der Datendatei. 
Wenn nicht anders angegeben, wird der senkrechte Strich 
genommen. 

Minimaler Platz für Absatz 

Benutzt # als die Anzahl der Zeilen eines Absatzes, die auf 
eine Seite passen müssen. Wenn nicht genug Platz vorhanden 
ist, beginnt eine neue Seite, bevor ein neuer Absatz ausgege- 
ben wird. Der Standardwert für # ıst 2. 

Zeilen zusammenhalten 

Erzwingt eine neue Zeile und stellt dann sicher, daß minde- 
stens # Zeilen zusammenhängend verfügbar sind. Wenn nicht 
genug Platz auf der Seite ist, beginnt eine neue Seite. Der 
Standardwert ıst Null, der Befehl wird also ignoriert. 

Nicht füllen 

Erzwingt eine neue Zeile und füllt dann keine Zeilen mehr. 
Dies bewirkt auch, daß der Blocksatz beendet wırd. Wenn 
Blocksatz wırksam war, wird er wieder aufgenommen, wenn 
die Zeilen wieder gefüllt werden. 
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.NnJ 


.nu 


.of 


.oh 


.pl 


.po 


.pr 


‚Im 


.TS 


kein Blocksatz 

Erzwingt eine neue Zeile und beendet den Blocksatz. Dieser 
Befehl berührt das Zeilenfüllen nicht, man erhält nur 
Flattersatz. 

Nicht unterstreichen 

Beendet das Unterstreichen ım Text, gleichgültig ob durch- 
gehend oder nicht. 


[Text] Fußzeile für ungerade Seiten 


Text wird als Fußzeile auf jeder ungeraden Seite benutzt, 
beginnend mit der nächsten. Wenn kein Text vorhanden ist, 
ist die Fußzeile leer, also wird eine Leerzeile gedruckt. 


[Text] Kopfzeile für ungerade Seiten 


[#] 


[#) 


Text wird als Kopfzeile auf jeder ungeraden Seite benutzt, 
beginnend mit der nächsten. Wenn kein Text vorhanden ist, 
ist die Kopfzeile leer, also wird eine Leerzeile gedruckt. 
Seitenlänge 

Benutzt # als Wert für die Seitenlänge. Der Standardwert für 
# ıst 66. Die minimale Seitenlänge ist die Summe aus .ml, 
.m2, .m3, und .m4 plus 1. Also müssen die Ränder vor die- 
sem Befehl gesetzt werden. 

Seitenoffset 

Benutzt # als neuen Wert für den Seitenoffset. Beim Druck 
auf ungeraden Seiten wird um diesen Wert nach rechts ver- 
schoben und auf geraden Seiten nach links. Diese Funktion 
kann man direkt beim Aufruf von FMT in der Befehlszeile 
durch -PO# angeben. der Standardwert für # ıst O. 


[Text} Eingabe-Aufforderung 


[#] 


[#] 


Fordert den Bediener zur Eingabe auf. Der Lautsprecher 
ertönt und auf dem Bildschirm erscheint die Meldung "enter: 
Text" wobeı das Wort Text für den Text steht, der dem Be- 
fehl folgt. Die Eingabe von der Tastatur wird genauso ver- 
arbeitet wie aus einer Datei. Die Eingabe wird durch eine 
Zeile beendet, in der nur ein Punkt steht. Diese Zeile wird 
bei der Textformatierung nicht berücksichtigt. 

Rechter Rand 

Benutzt # als neuen Wert für den rechten Rand. Der rechte 
Rand ist die Spalte, ın der das letzte Zeichen erscheint, 
wenn Blocksatz wirksam ist. Der Standardwert für # ıst 11. 
Platz reservieren 

Hält # Zeilen frei. Wenn nicht genug Zeilen auf der aktuel- 
len Seite vorhanden sind, wird eine neue Seite begonnen und 
dann die angeforderte Zeilenzahl freigelassen. Höchstens 
eine Seite kann freigehalten werden. 
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.so Datei Quelldatei für Text 


.sq [#] 


.sp [#] 


.ti [#] 


ul [#] 


[Text] 


Meldungen 
MELDUNG 


Benutzt die genannte Datei an diesem Punkt als Quelldatei. 
Wenn die Dateı komplett gelesen wurde, mit der nächsten 
Zeile fortgefahren. 

Zusammendrücken 

Erzwingt eine neue Zeile und rückt dann von beiden Ränder 
um # Stellen nach innen ein. Der Standardwert für # ist 
Null. Ab dem Befehl .sg wird wieder normal gedruckt. Der 
Befehl .sqg +# addiert zum schon wirksamen Wert und .sq -# 
subtrahiert davon. 

Leerzeilen 

Erzwingt eine neue Zeile und übergeht dann # Zeilen. Der 
Standardwert für # ıst 1. 

Zeitweise einrücken 

Erzwingt eine neue Zeile und nimmt dann als Einrückwert 
#, aber nur für die nächste Zeile. Folgende Zeilen verwen- 
den wieder dem laufenden Wert. Durch ein Plus oder Minus 
vor # wird dieser Wert zum laufenden addiert oder subtra- 
hiert, Der Standardwert für # ıst 0, der Befehl wird also 
ignoriert. 

Nicht durchgehend unterstreichen 

Unterstreicht die folgenden # Zeilen ohne die Leerzeichen 
zwischen den Wörtern. Wenn # Null ıst, wird das Unter- 
streichen beendet. Der Standardwert für # ist 1. 

Kommentar 

Zwei aufeinanderfolgende Befehlszeichen kennzeichnen eine 
Kommentarzeile, die von FMT nicht beachtet wırd. Man 
kann zeitweise einen Befehl unwirksam machen, indem man 
eın weiteres Befehlszeichen davor setzt. 


ERKLÄRUNG 


ready printer... 


set page # 


Der Bediener soll sicherstellen, daß Papıer eingespannt ist 
und der Drucker auf Online steht und dann RETURN oder 
ENTER drücken. 


Der Bediener soll das nächste Blatt einspannen und dann auf 
RETURN oder ENTER drücken (Control-N geht direkt zur 
nächsten Seite). 


copy # ready printer 


Bereite den Drucker für Kopie # vor. (Control-N geht di- 
rekt zur nächsten Seite). 
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page # 
Sagt dem Bediener, welche Seite gerade gedruckt wird, so 
daß ein Neustart auf der letzten gedruckten Seite möglich 
ist. 

enter: <Beschreibung> 
Der Bediener soll Text eingeben und die Eingabe dann mit 
einer Zeile abschließen, die nur einen Punkt enthält. 

note: <Zeile> 
Die angezeigte Zeile ist entweder ein Kommentar, ein 
falscher Formatierbefehl oder eine Textzeile, die unbeab- 
sichtigt mit einem Punkt beginnt (oder einem anderen Be- 
fehlszeichen). 

error: <Zeile> 
Die angezeigte Zeile enthält einen Formatierbefehl mit 
einem numerischen Argument, der nicht ausgewertet werden 
kann. 
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LST (List) 
LST [Datei) [-C#) [-PL#] [-Pw#]) [-NB] [-NN] [-NP] 
Beschreibung 


LST kopiert eine Eingabedateı zur Standardausgabe. Wenn eine Datei in der 
Befehlszeile angegeben ist, wird sie als Eingabe genommen, sonst wird die 
Standardeingabe angenommen. Wahlweise werden die Zeilen numeriert, er- 
scheint dıe Ausgabe ın mehreren Spalten pro Seite und/oder es wird eine 
Pause zwischen den Seiten gemacht. LST hat den Hauptzweck, Textdateien 
am Bildschirm auszugeben, man kann es jedoch auch in Verbindung mit 
FMT oder PRT benutzen, um Listings auf dem Drucker zu erhalten, deren 
Zeilen numeriert sind und/oder in mehreren Spalten aufgeteilt sind. 


Der Schalter -C # sagt LST, wieviele Spalten pro Seite in der Ausgabe er- 
scheinen sollen. Der Standardwert ist eins. LST teilt die Seite durch #, um 
die Breite der einzelnen Spalten zu bestimmen. Wenn eine Zeile zu lang ist 
um in die Spalte zu passen, erscheint sie in der nächsten in der gleichen 
Spalte. Normalerweise werden alle Zeilen kürzer als die Spaltenbreite sein; 
wenn jedoch eine Zeile genauso lang ist wie die Spalte breit ist, erhält man 
einen Spaltenüberlauf, bevor das Ende der Zeile entdeckt wurde. Als Er- 
gebnis erhält man eine leere Zeile in der Spalte. Man kann diese Leerzeilen 
durch den Schalter -NB entfernen. 


Der Schalter -PL # gibt LST die Seitenlänge ın Zeilen an. Dies ist nicht die 
physikalische Länge einer Seite, sondern die Zahl der Zeilen, die LST auf 
die Seite druckt. Die Standard-Seitenlänge hängt davon ab, ob die Ausgabe 
auf die Diskette umgeleitet wurde. Wenn ja, wird die Länge aus PTR- 
HIGH-PTRSKIP-PTRHDR (identisch mit den von PRT benutzten) berech- 
net; sonst werden CRTHIGH-I Zeilen (eine weniger als die Länge des 
Bildschirms) angenommen. Diese Symbole sind in TOOLS.H definiert und 
können an die Erfordernisse angepaßt werden (das Programm muß dann 
neu kompiliert werden). 


Der Schalter -PW# gibt LST die Breite einer Seite in Zeichen an. Auch der 
Standardwert für dıe Breite einer Seite hängt davon ab, ob die Ausgabe zur 
Diskette umgeleitet wurde oder nicht. Wenn ja, wırd PTRWIDE-I ange- 
nommen; sonst CRTWIDE-1. Diese Symbole sınd ın TOOLS.H definiert 
und können an die Erfordernisse angepaßt werden. 


Sofern man LST nichts anderes sagt, werden die Zeilen numeriert. Mit - 
NN (no numbers) schaltet man die Numerierung aus. Zeilennummern er- 
scheinen rechtsbündig mit Leerstellen aufgefüllt in einem vier Zeichen 
breiten Feld am Anfang jeder Spalte. Wenn die Zeilennummerierung unter- 
drückt wırd, kann die gesamte Spaltenbreite für Text genutzt werden. 
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Wenn man nichts anderes angibt, macht LST zwischen den Seiten eine 
Pause und wartet auf Antwort, bevor es weitermacht. Dadurch hat man ge- 
nug Zeit den Bildschirminhalt zu studieren, bevor er wegscrollt. Bei der 
Ausgabe auf den Drucker kann man einzelne Blätter verwenden. Wenn man 
keine Pause haben möchte kann man den Schalter -NP angeben (no pause). 
In diesem Fall fährt LIST automatisch fort und läßt keine Leerzeilen zwi- 
schen den Seiten. Die Ausgabe erscheint immer noch in (möglicherweise) 
mehreren Spalten, aber ohne Leerzeilen zwischen den Seiten. Wenn die 
Ausgabe auf Diskette erfolgt, gibt es niemals Pausen zwischen den Seiten. 
Es ıst ın diesem Fall nicht notwendig, den -NP Schalter anzugeben. 


Die letzte Zeile einer Seite befindet sich am Ende der am weitesten rechts 
stehenden Spalte und die erste Zeile der nächsten Seite befindet sich am 
Anfang der am weitesten links stehenden Spalte. 


Wenn man einen Seitenvorschub vor dem Drucken braucht, kann man die 
Ausgabe zur Diskette schicken und diese Datei dann als Eingabe für PRT 
benutzen. Die Standard-Seitenlänge stimmt überein, so daß der Vorschub 
immer genau an der richtigen Stelle erfolgt. 


LST ist besonders nützlich, wenn man sich kurze Textzeilen anschauen 
möchte, Zeilen, die nur aus einem Wort bestehen, wie man sie etwa in 
Wörterbüchern findet. Es spart eine Menge Papier und macht auch das 
Ansehen am Bildschirm viel leichter. 


Beispiele 
BEFEHL KOMMENTAR 


LST <ABC -C3 
Gibt auf dem Bildschirm den Inhalt der Datei ABC in drei 
Spalten mit Zeilennummerierung und Pause zwischen den 
Seiten aus. 

LST <ABC >DEF -C8 -PwW132 -NP 
Kopiert die Datei ABC nach DEF, numeriert die Zeilen und 
bringt sie in ein acht-spaltiges Format auf eine Seite, die 
132 Zeichen breit ist. PRT kann dann benutzt werden, um 
dıe Datei DEF mit Seitenvorschub und Kopfzeilen zu auszu- 
drucken. 
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Meldungen 
MELDUNG ERKLÄRUNG 
waiting... 


LST wartet auf die Antwort des Bedieners mit Return oder 
Enter, bevor die nächste Seite angezeigt wird. 
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MRG (Merge) 
MRG Datei [Datei] [-1|-2|-3|-F] 
Beschreibung 


MRG nimmt zwei sortierte Textdateien, führt sie zusammen und gibt das 
Ergebnis aus. Die Eingabedateien müssen vollständig aufsteigend sortiert 
sein. Verglichen wird lexikographisch, also haben Klein- und Großbuch- 
staben den gleichen Rang und Sonderzeichen haben einen niedrigere Wert 
als Buchstaben. 


Die Ausgabe kann aus beiden Dateien bestehen oder aus Zeilen, die nur in 
der ersten oder nur in der zweiten vorkommen. 


Die erste genannte Datei in der Befehlszeile wird als erste Datei bezeichnet. 
Die nächste angegebene Datei heißt die zweite Datei. Wenn eine zweite 
Datei nicht angegeben wird, wird stattdessen die Standardeingabe ange- 
nommen. Natürlich kann die Standardeingabe zur Diskette umgeleitet wer- 
den; in diesem Fall kann die Umlenkungsanweisung (zweite Dateı) irgend- 
wo in der Befehlszeile stehen, sogar vor der ersten Datei. 


Wenn nicht anders angegeben, gibt MRG den gesamten Inhalt beider zu- 
sammengeführter Dateien aus. Übereinstimmende Zeilen in den beiden 
Zeilen erscheinen jedoch nur einmal ın der Ausgabe. 


Wenn man den Schalter -] angibt, werden nur die Zeilen aus der ersten 
Datei ausgegeben, die nicht mit der zweiten Datei übereinstimmen; Zeilen 
aus der zweiten Dateı erscheinen überhaupt nicht. 


Wenn man den Schalter -2 angibt, werden nur die Zeilen aus der zweiten 
Datei ausgegeben, die nicht mit der ersten Datei übereinstimmen; Zeilen 
aus der ersten Dateı erscheinen überhaupt nicht. 


Wenn man den Schalter -3 angibt, werden die Zeilen aus beiden Dateien 
ausgegeben, die in beiden identisch sind. Wenn diese identischen Zeilen 
mehrfach vorhanden sind, werden sie sooft aus derjenigen Datei ausgege- 
ben, in der sie weniger häufig stehen. 


Der Schalter -F bewirkt, daß alle Zeilen formatiert ausgegeben werden. 
Dadurch erscheinen alle Zeilen, die nur in der ersten Dateı vorkommen, am 
äußerst linken Rand; Zeilen, die nur in der zweiten Datei vorkommen, 
werden zwei Stellen eingerückt; Zeilen die in beiden Dateien überein- 
stimmen, werden um weitere zwei Stellen eingerückt. Um die Art der Zei- 
len erkennen zu können, werden den drei Spalten die Zahlen 1), 2) oder 3) 
vorangestellt, da es möglich sein kann, daß es nur eine Zeilenart gibt. 
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Beispiele 
BEFEHL KOMMENTAR 


MRG ABC DEF -1 
Führt die Dateien ABC und DEF zusammen, wobei auf dem 
Bildschirm nur die Zeilen von ABC gezeigt werden, die 
nicht in DEF vorhanden sind. 

MRG ABC DEF -F >LST: 
Führt die Dateien ABC und DEF zusammen und gibt ein 
formatiertes Listing auf dem logischen Gerät LST: aus. 

MRG ABC DEF >GHI 
Führt die Dateien ABC und DEF zusammen und speichert 
die kombinierte Ausgabe beider Dateien ın der Dateı GHI. 


Meldungen: keine 
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PRT (Print) 


PRT [Datei]... ? 


[-[?]]) [-NN] [-NHI-NS) [-IM#] [-BP#] 
[-EP#] [-P] L[-NR] 
Beschreibung 


PRT kopiert eine oder mehrere Textdateien zur Standardausgabe. Wenn die 
Standardausgabe nicht vom Bildschirm weggelenkt wurde, wird sie ge- 
schlossen und auf LST: wieder geöffnet. Daher ist LST: die Standardaus- 
gabe für PRT. Normalerweise numeriert PRT die Zeilen durch, unterteilt 
die Zeilen in Seiten zu 56 Zeilen und stellt eine Kopfzeile über jede Seite 
mit dem Dateinamen und der Seitennummer. Die Eingabe erfolgt über die 
Standardeingabe, die wie immer umgeleitet werden kann. Wenn eine Liste 
von Dateinamen in der Befehlszeile angegeben wurde, werden sıe auch in 
dieser Reihenfolge gedruckt, jeweils mit einem Seitenvorschub zwischen 
den Dateien. In diesem Fall wird die Standardeingabe nicht benutzt. 


Wenn sie vorhanden sınd, verarbeitet PRT auch Include-Dateien. Die An- 
weisung in C heißt "#include Datei", für die Textformatierung heißt sie ".so 
Datei". Die Datei erscheint in der Ausgabe sofort hinter den genannten An- 
weisungen. Die Zeilennummerierung beginnt für jede dieser Dateien wieder 
bei 1, geht jedoch für die erste Datei ununterbrochen weiter. Die beiden 
genannten Anweisungen können beliebig tief geschachtelt werden, begrenzt 
nur durch die Speicherkapazität. 


Die Parameter, die man bei PRT angeben kann sind: 


[Datei]... 
Druckt die genannten Dateien anstatt die Standardeingabe 
(2) Druckt alle eingeschlossenen Dateien mit einer Erweiterung 
von ?, wobei ? aus einem bis drei Zeichen besteht. Wenn ? 
leer ist, werden alle eingeschlossenen Dateien gedruckt. 


-NN Keine Zeilennummerierung 

-NH Keine Kopfzeilen 

-NS Keine Seiten übergehen (und keine Kopfzeilen) 

-LM# Linker Rand mit # Stellen. Der Standardwert ist 0 Stellen. 

-BP# Druckbeginn auf Seite # 

-EP# Druckende auf Seite # 

-P Pause nach jeder Seite. Standardmäßig wird fortlaufend ge- 
druckt. 


-NR Keine "ready printer..." Aufforderung 
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Beispiele 
BEFEHL KOMMENTAR 


PRT ABC DEF >PUN: 
Druckt die Dateien ABC und DEF auf dem logischem Gerät 
PUN: mit einer Kopfzeile auf jeder Seite und einem Seiten- 
vorschub zwischen den Dateıen. 

PRT SORT.C .C 
Druckt SORT.C zusammen mit allen C-Dateien, dıe darın 
eingeschlossen sind. Die Ausgabe geht nach LST.. 


Meldungen 
MELDUNG ERKLÄRUNG 


ready printer... 
PRINT wartet darauf, daß Papier eingespannt wird und auf 
Online geschaltet wird, damit Daten vom Computer ge- 
schickt werden können. 

page # 
Zeigt an, welche Seite gerade gedruckt wird, so daß ein 
Neuanfang möglich ist. 
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SRT (Sort) 
SRT [-C#|-F#?]) [-D) [-UJ] [-Tx)] [-9] 
Beschreibung 


SRT liest die Standardeingabe, sortiert sie Zeile für Zeile und schreibt die 
sortierten Daten zur Standardausgabe. Verarbeitet werden nur Standard- 
Textdateien (ASCII-Format) keine binären Dateien. Die Dateien können 
beliebig groß sein. 


Wenn kein Sortierschlüssel angegeben wurde, wird die ganze Zeile als 
Schlüssel genommen. Das heißt, der Vergleich beginnt mit dem ersten Zei- 
chen der beiden zu vergleichenden Zeilen von links nach rechts und ver- 
glichen werden die entsprechenden Zeichen solange bis ein Unterschied 
festgestellt wird. Die Zeile, deren nicht übereinstimmendes Zeichen lexika- 
lısch tiefer steht, wırd beı aufsteigender Sortierung zuerst ausgegeben, bei 
absteigender Sortierung zuletzt. 


Zwischen Groß- und Kleinbuchstaben wird kein Unterschied gemacht. 
Sonderzeichen haben die gleiche relative Position zueinander, wie in der 
ASCIH-Tabelle, gehen jedoch allen Buchstaben voraus. Das ASCII-Zeichen 
DEL (Wert 127 dezimal) hat den höchsten Wert. 


Wenn eine Zeile länger als die andere ist und am Ende der kürzeren Zeile 
kein Unterschied gefunden wurde, wird angenommem, daß die kürzere 
"kleiner" als die längere ist. 


Standardmäßig wırd aufsteigend sortiert. Wenn jedoch der Schalter -D in 
der Befehlszeile erscheint, wird die Reihenfolge umgekehrt. 


Wenn nur ein Teil zum Vergleich herangezogen wird, kann einer von zwei 
Schaltern angegeben werden, um anzuzeigen, wo der Sortierschlüssel gefun- 
den werden kann. Der Schalter -C# informiert SRT, daß der Schlüssel in 
Spalte # beginnt und bis zum Zeilenende reicht. Wenn # größer ıst als die 
Zeichen in der Zeile, wird der Sortierschlüssel als Null angenommen und 
solche Zeilen werden bei aufsteigender Sortierung an den Anfang sortiert. 


Der Schalter -F#? sagt SRT, daß das Feld # ın einer Zeile als Sortier- 
schlüssel genommen werden kann. Ein Feld kann in unterschiedlichen Zei- 
len unterschiedlich lang sein und kann auch in verschiedenen Spalten 
beginnen. Felder werden durch eın besonderes Zeichen definiert. Dieses 
Zeichen steht im Schalter hınter der Feldnummer. Das erste Feld ist alles ın 
einer Zeile bis zum, aber nicht einschließlich, ersten definierten besonderen 
Zeichen. Das zweite besteht aus dem Inhalt zwischen den beiden definier- 
ten Zeichen. Das Zeilenende ist zugleich auch das Ende für das letzte Feld. 
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Wenn zwei Zeilen verglichen werden, werden die Schlüsselfelder ım allge- 
meinen an verschiedenen Stellen stehen und unterschiedlich lang sein. Die 
Vergleichsmethode entspricht der von ganzen Zeilen. Wenn ein Feld kürzer 
als das andere ist und die beiden Felder bis zum definierten Endezeichen 
des kürzeren Feldes übereinstimmen, wird das kürzere Feld niedriger in 
der Sortierreihenfolge eingestuft. Wenn die definierten Zeichen nebenein- 
ander stehen, begrenzen sıe ein leeres Feld, das heißt das Feld mit einer 
Länge von Null zählt als ein Feld. Wenn es als Schlüssel verwendet wird, 
erscheint es tiefer, als alle Felder mit einer Länge ungleich Null. 


Wenn kein Zeichen für ? angegeben ist, werden alle Leerstellen genommen. 
Diese Zeichen sind alle Sonderzeichen, die zwischen Feldern mit druck- 
baren Zeichen stehen. In einer Textdatei werden durch diese Zeichen Wör- 
ter getrennt. Der Schalter -F5 sagt SRT demnach, daß jedes fünfte Wort in 
einer Zeile als Schlüssel genommen werden soll. 


Da die Ausgabe von SRT identische Zeilen zusammenführt (wenn kein Sor- 
tierschlüssel angegeben ist), ist SRT auch der natürliche Ort, um doppelte 
Zeilen auszusondern. Durch den Schalter -U kann man genau dies errei- 
chen. Wenn dieser Schalter angegeben ist, erscheinen nur einmalige Zeilen 
in der Ausgabe. Der Vergleich auf Einmaligkeit nimmt immer die gesamte 
Zeile, auch wenn ein Sortierschlüssel angegeben wurde. 


Da die zu sortierenden Dateien größer als der verfügbare Speicher sein 
können, ist es oft nötig, daß SRT Zwischendateien auf der Diskette anlegt, 
die Teile der schon sortierten Eingabedatei enthalten, während der Rest 
noch weiter sortiert wird. Es werden automatisch so viele Zwischendateien 
angelegt, wie für SRT erforderlich sind. Am Ende der Eingabe werden die 
Zwischendateien für die Ausgabe zusammengeführt. Anschließend werden 
die Zwischendateien gelöscht. Die Namen dieser Dateien sind SORTOI. $$$, 
SORTO02.$$$ und so weiter. Bei Unterbrechung eines Sortierlaufs können 
diese Dateien auf der Diskette stehen bleiben. Man sollte sie dann löschen. 


Wenn nicht anders angegeben, werden die Zwischendateien auf dem Stan- 
dardlaufwerk angelegt. Der Schalter -Tx (x gibt ein Laufwerk von A bis G 
an) legt ein besonderes Laufwerk für die Zwischendateien fest. 


SRT benutzt normalerweise den Shell-Sortieralgorithmus für die Sortierung 
der Zeilen im Speicher. Ein zweiter Algorithmus, Quick-Sort, ist auch 
verfügbar, der durch den Schalter -Q aufgerufen wird. Dieser Algorithmus 
ıst schneller, hat aber auch Nachteile. Wenn die Eingabe schon sortiert ist, 
wird er sehr viel langsamer als der Shell-Sort und benutzt auch sehr viel 
mehr Speicher, so daß es zu einem Speicherzuordnungsfehler kommen 
kann. Wenn dies geschieht, wird ein M angezeigt und der Lauf beendet. 
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Da die meiste Zeit in einem Sortierlauf bei der Ein- und Ausgabe ver- 
braucht wird, ist die größere Schnelligkeit des Quick-Sorts kein großer 
Vorteil; er ist jedoch für Systeme mit größerem Speicher und/oder schnel- 
len Festplatten beibehalten worden. 


Beispiele 
BEFEHL KOMMENTAR 


SRT <ABC >DEF -P5| 
Sortiert die Datei ABC nach dem Sten Feld, getrennt durch 
das Zeichen | und schreibt die Ausgabe in die Datei DEF. 
SRT <ABC -U 
Sortiert die Datei ABC nach ganzen Zeilen und zeigt nur 
einmalige Zeilen an der Konsole an. 


Meldungen 
MELDUNG ERKLÄRUNG 


file too large 
Die Eingabedatei ist zu groß, da mehr als 99 Zwischen- 
dateien erforderlich sind. 
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TRN (Trans) 
TRN [-]von [nach] 


Beschreibung 


TRN kopiert die Standardeingabe zur Standardausgabe und übersetzt dabei 
ausgewählte Zeichen in neue Werte. Der Parameter von ist eine Liste der zu 
ändernden Zeichen. Zwischen den Zeichen ın der Liste dürfen keine 
Leerzeichen stehen. In nach stehen die neuen Zeichen, die den aus von zu- 
gewiesen werden sollen. Das erste von-Zeichen entspricht dem ersten nach- 
Zeichen, das zweite von-Zeichen, dem zweiten nach-Zeichen und so fort. 


Demnach kopiert der Befehl "TRN <DATEII >DATEI2 abc ABC" die Datei 
DATEII nach DATEI2 und wandelt dıe Kleinbuchstaben abc in Großbuch- 
staben ABC um. 


Wichtig: Man muß SUBMIT und den CCP patchen, damit Kleinbuchstaben 
akzeptiert werden können. Genaueres ist im Anhang A zu finden. 


Damit es einfacher ist, das ganze Alphabet oder Teile davon anzugeben, 
braucht nur der erste und der letzte Buchstaben, durch Bindestrich verbun- 
den, eingegeben werden. Durch diese Abkürzung werden alle dazwischen 
liegendenen Buchstaben spezifiziert. Also kopiert der Befehl "TRN 
<DATEII >DATEI2 a-z A-Z" die Dateı DATEII nach DATEI2 und wan- 
delt alle Kleinbuchstaben in Großbuchstaben um. Der Befehl "TRN a-zA-Z 
A-Za-z <DATEIIl >DATEI2" wandelt beim Kopieren von DATEII nach 
DATEI2 alle Kleinbuchstaben in Großbuchstaben um und umgekehrt. Der 
Befehl "TRN <DATEII a-c d-f >DATEI2" wandelt während des Kopierens 
von DATEII nach DATER, a nach d, b nach e und c nach f um. 


Escapesequenzen können in den Listen von und nach benutzt werden. Da 
beide dieser Listen durch ein Leerzeichen oder Tab-Zeichen beendet wer- 
den, müssen diese Werte ın der Liste mit :s und :t angegeben werden. Ein 
Doppelpunkt muß doppelt eingegeben werden. 


Wenn die nach-Liste länger ist als die von-Liste, werden die restlichen 
Zeichen nicht weiter beachtet. 


Wenn auf der anderen Seite die nach-Liste kürzer als die von-Liste ist, 
operiert TRN zusammenschiebend. Die nach-Liste wird automatisch auf die 
Länge der von-Liste erweitert, indem das letzte Zeichen der nach-Liste 
wiederholt wird. Anschließend schiebt TRN alle vorkommenden Zeichen zu 
einem einzigen Zeichen zusammen. Wenn man zum Beispiel jedes Wort in 
einem Text auf je einer Zeile haben möchte, genügt dafür der Befehl 
"TRN <DOCI >DOC2 :s:t :n". Leerzeichen und Tabs würden beide in Zei- 
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chen für Neue-Zeile umgewandelt, dann würden diese aufeinanderfolgen- 
den Zeichen zu einem Zeichen zusammengeschoben. Damit verhindert man 
in der Ausgabe Leerzeilen. 


Um es zu wiederholen, TRN schiebt das letzte Zeichen ın der nach-Liste 
zusammen, wenn die nach-Liste kürzer als die von-Liste ıst. Da dies gilt, 
wenn die nach-Liste mehr als ein Zeichen enthält, ist es möglich, einige 
Zeichen umzuwandeln, während andere zusammengeschoben werden. In 
dem Sonderfall, wenn die nach-Liste vollständig entfällt, werden überein- 
stimmende Zeichen aus der von-Liste in der Ausgabe gelöscht. 


Manchmal möchte man alle bıs auf ganz bestimmte Zeichen löschen oder 
zusammenschieben. Für diesen Zweck muß die Tilde (-), die nicht bedeu- 
tet, der von-Liste vorangestellt werden. 


Wenn dem Programmnamen in der Befehlszeile ein Bindestrich allein folgt, 
wird dieser als Schalter ohne Bedeutung interpretiert, das heißt der Bedie- 
nungshinweis wird angezeigt. Möchte man also Bindestriche aus der Datei 
entfernen, muß der Binsdestrich ın der Befehlszeile als Escape-Sequenz 
erscheinen. 


Beispiele 
BEFEHL KOMMENTAR 


TRN <ABC >DEF -[a-2][A-2] :n 
Kopiert die Datei ABC nach DEF, schiebt alle Nichtbuch- 
staben zu Neue-Zeile-Zeichen zusammen (also wird alles 
außer Wörtern entfernt, so daß jedes Wort in einer Zeile 
steht). 

TRN <ABC :[:]{}() 
Zeigt auf dem Bildschirm nur die eckigen, runden und ge- 
schweiften Klammern aus der Dateı ABC an. 


Meldungen 
MELDUNG ERKLÄRUNG 


from-list too large 
Die intern erweiterte von-Liste ıst zu groß, um in den reser- 
vierten Speicherplatz zu passen. 

to-list too large 
Die intern erweiterte nach-Liste ıst zu groß, um in den re- 
servierten Speicherplatz zu passen. 
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6 Kompilierung der Quellprogramme 


Es ist natürlich aufgrund der Vielzahl der Systeme, auf denen das Small-C- 
Entwicklungssystem läuft, unmöglich, für alle Gegebenheiten eine genaue 
Anleitung zur Art und Weise der Kompilierung und vor allem der Disket- 
tenaufteilung zu geben. Deshalb beschränkt sich diese Beschreibung auf ein 
sehr einfaches System mit 64 KByte Speicher, einem Diskettenlaufwerk (ca. 
160 KByte) und dem Betriebssystem CP/M Plus. 


Zunächst wird anhand von zwei einfachen Beispielen aus den Small-Tools 
gezeigt, wie man ein C-Programm kompiliert und wie man bei der genann- 
ten Konfiguration die Disketten so aufteilt, daß auch größere Programme 
kompiliert werden können. 


Diskettenaufteilung 


Damit alle Quellprogramme des Small-C-Entwicklungssystems kompiliert 
werden könnne, müssen bei der angenommenen Konfiguration die benö- 
tigten Programme auf drei Disketten verteilt werden. Zusätzlich wird auf 
jeder Diskette das Kopierprogramm PIP benötigt oder unter CP/M 2.2 ein 
anderes Kopierprogramm, das es erlaubt, Dateien mit einem Laufwerk von 
einer Diskette zu einer anderen zu kopieren (zum Beispiel FILECOPY bei 
einigen Schneider-Computern). Es folgt eine Aufstellung der Disketten- 
inhalte und von welcher Diskette diese Programme kopiert werden müssen. 


Diskette 1: C-Compiler 

PIP.COM von der Betriebssystem-Diskette 
CC.COM von der Diskette SC1 

STDIO.H von der Diskette SC1 

Diskette 2: Small-Mac-Assembler 


PIP.COM von der Betriebssystem-Diskette 
MAC.COM von der Diskette SM 


Diskette 3: Linker 


PIP.COM von der Betriebssystem-Diskette 
LNK.COM von der Diskette SM1 
C.LI1B von der Diskette SM1 
C.NDX von der Diskette SM] 


Ein einfaches Beispiel 


Im ersten Beispiel soll das Small-Tools-Programm CPT (Crypt) kompiliert 
werden, denn es ıst das kleinste lauffähige Programm im Small-C-Entwick- 
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lungssystem und benötigt darüber hinaus keine besonderen Include-Dateien. 
Kopieren Sie also nun noch die Datei CPT.C von der Diskette ST auf die 
Diskette 1 (C-Compiler). Das Programm CPT sieht folgendermaßen aus: 


* 


** cpt.c -- encrypt or decrypt ASCII or binary files 


ar 


> Copyright 1982 J. E. Hendrix. All rights reserved. 
/ 


#include <stdio.h> 

#def ine NOCCARGC 

#define MAXKEY 81 

#define CTLZ_ 26 

main(argc, argv) int argc, *argv; ( 
char c, x. [MAXKEY]; 
Int I en; 
boten 4096); 
keylen=getarg(1, key, MAXKEY, argc, argv); 
ifC(keylen==EOF) ein m ='!- 1)) { 

eher ey\n", stderr); 
rt(7 


leerer &c, 1) > 0) € 


poLll(YES); 
iflisatty(stdin) && (c==CTL2)) break; 
c=c”key[i-1]; 
if(uritelstdout, &c, 1) !=1)<C 
el error\n", stderr); 
rt(7); 


In =CiXkeylen)+1; 
> 


Geben Sıe nun unter CP/M folgenden Befehl ein: 
A>CC_-M_CPT 


Dadurch wird der Small-C-Compiler aufgerufen. Der Parameter -M bedeu- 
tet, daß der Compiler während der Bearbeitung die erste Zeile jeder Funk- 
tion auf dem Bildschirm ausgegebn soll (Monitor). Dadurch weiß man dann 
immer, wie weit der Compiler mit seiner Arbeit fortgeschritten ist und 
kann zusätzlich eventuelle Fehler besser lokalisieren. CPT ist der Name des 
zu kompilierenden Programms. Die Dateinamenserweiterung C braucht 
nicht angegeben zu werden. Der Compiler zeigt nun beim Kompilieren fol- 
gendes an: 


Small-C C iler, Version X.X (Rev. XX) 
Copyright 1982, 1983 3. E. Hendrix 


main(argc, argv) int argc, *argv; { 


A> 


Nach einigen Sekunden meldet sıch das Betriebssystem und das Programm 
ist in 8080-Assemblercode übersetzt. Der Assemblercode steht auf der Dis- 
kette nun in der Datei CPT.MAC. Bitte sehen Sie sich diese Datei einmal 
mit dem Betriebssystembefehl TYPE an. Das sıeht dann etwa so aus: 
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Ccci: 
main:: 

LXI H,-86 
DAD SP 
SPHL 

LXI H,O 
PUSH H 

LXI H,4096 
PUSH H 
CALL auxbuf 
POP B 

POP B 

LXI H,O 
DAD SP 


CALL CCGINT## 
PUSH H 
LXI H,98 


DAD SP 

CALL CCGINTAH 

PUSH H 

CALL getarg 
G°: 


‘““ 


DAD SP 

CALL CCGINT#A 
XCHG;; 

POP B 

POP H 

PUSH H 

PUSH B 

CALL CCDIV#AR 
XCHG; ; 

LX1 D,1 

DAD D 


POP D 

CALL CCPINT#AH 
JMP CC4 

Cc5: 

LXI H,86 

DAD SP 

SPHL 


RET 
CC2:DB 117,115,97,103,101 ‚58 ‚3267,80 
DB 32,107,101,121,10,6,111,117,116.112 
DB 117,116,32,101,114,114 an 414040.0 
EXT read 

EXT isatty 

EXT poll 

EXT auxbuf 

EXT abort 

EXT fputs 

EXT write 

EXT getarg 

EXT Ulink 


84 


1} 
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Kopieren Sie diese Dateı nun mit dem Programm PIP auf die Diskette 2 
(Small-Mac-Assembler). Geben Sie hier nun folgenden Befehl ein: 


A>MAC_-L CPT 


Damit wird der Small-Mac-Makroassembler aufgerufen. Der Parameter -L 
bedeutet, daß er ein Listing ausgeben soll. CPT ist der Name der vom 
Compiler erzeugten Assemblercode-Datei. Auch hier braucht die Namens- 
erweiterung .MAC nicht angegeben werden. Der Assembler meldet sich nun 
mit seiner Startmeldung: 


Small-Mac Assembler, Version X.X (Rev. XX) 
Copyright 1985 J. E. Hendrix 


Dann wird das Programm so ausgegeben, wie es auf den folgenden Seiten 
zu sehen ist. In der ersten Zeile auf jeder Seite wird der Dateiname und 
die aktuelle Seitennummer ausgegeben. Für jede Assemblerzeile werden 
folgende Informationen ausgegeben: 


Zeilennummer (line), 

Adresse des Assemblercodes (loc), 

der erzeugte Objektcode (falls vorhanden), 
der Quellcode selbst (source). 


oO 000 


file: CPT. 
line loc 
1 0 
2 0 
3 0 
& 3 
5 4 
6 5 
7 8 
8 9 
9 C 
10 D 
11 10 
12 11 
13 12 
14 15 
15 16 
16 17 
17 1A 
18 1B 
19 1E 
20 IF 
21 20 
22 23 
23 24 
24 27 
25 28 
26 28 
27 2C 
28 2F 
0e9 30 
30 33 
31 34 
32 37 
33 38 
34 3B 
35  3C 
36 3D 
37 3E 
38 3F 
39 42 
40 43 
41 &4L 
42 47 
43 4A 
44 48 
45 4£ 
46 4 
47T 52 
48 53 
19 56 
50 59 
51 SA 
2 5D 
53 5E 
54 5f 


MAC page: 1 


---object---- 


FFAA 


21 0000 
1000 
0000 


21 0000 


0001 
0008 


0051 
0062 
0000 
0062 
0029! 
0000 
000A 


0000 
FFFF 
0000 
0006 
0000 


002D 
0048" 


0000 


0077‘ 


source 


CcCc1: 

main:: 

LXI H,-86 
DAD SP 

SPHL 

LXI H,O 
PUSH H 

LXI H,4096 
PUSH H 

CALL auxbuf 
POP B 

POP B 

LXI H,O 

DAD SP 

PUSH H 

LXI H,1 
PUSH H 

LXI H,8 

DAD SP 

PUSH H 

LXI H,81 
PUSH H 

LXI H,98 
DAD SP 

CALL CCGINTAR 
PUSH H 

LXI H,98 
DAD SP 

CALL CCGINT#AR 
PUSH H 

CALL getarg 
XCHG;; 


CALL CCPINTA# 
POP D 


LXI H,-1 

CALL CCEQ#HH#H 
PUSH H 

LXI H,6 

DAD SP 

CALL CCGCHAR#R 
XCHG; ; 

LXI H,45 

CALL CCEQ#H# 


POP D 
CALL CCOR## 
M 
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file: CPT.MAC 


page: 2 
----object---- 
015D' 

0002 

0000 


0007 
0000 


0002 
0001 
0040' 


0000 
0057 


0001 
0000 


0157" 


0157" 
0001 


0000 
0000 
0000 


OOCC! 
0055 


0050' 
O001A 
0057' 


DOCC"! 


source 


LXI H,CC2+0 
PUSH H 

LXI H,2 
PUSH H 
CALL fputs 
POP B 

POP B 

LXI H,7 
PUSH H 
CALL abort 
POP B 


CCc3: 

LXI H,2 

DAD SP 

XCHG;; 

LXI H,1 

rt CCPINTA# 


CALL read 
POP B 

POP B 

POP B 

XRA A 

ORA H 

JM CC5 
ORA L 

JZ Cc5 


CALL isatty 
POP B 


MOV A,H 

ORA L 

32 Cc7 

LXI H,85 

DAD SP 

CALL CCGCHAR## 
XCHG; ; 


LXI H,26 
CALL CCEQ## 
MOV A,H 

ORA L 

32 CC7 


file: CPT. 
Line loc 
109 C6 
110 cY9 
111 cc 
112 cc 
113 CF 
114 CF 
115 DO 
116 D1 
117 04 
118 D7 
119 D7 
120 DA 
121 DB 
122 DC 
123 _DF 
124  EO 
125 E3 
126 E4 
127 _ E7 
128 EB 
129 EY 
130 EC 
131 ED 
132 FO 
133 Fl 
134  F4 
135  F7 
136 F8 
137 _ F9 
138 FC 
139 FD 
140 100 
1413 101 
142 102 
143 103 
144 106 
1455 107 
146 10A 
147 108 
148 10C 
149 10F 
150 110 
151 113 
152 114 
153 115 
154 116 
155 117 
156 11A 
157 11D 
158 11E 
159 11F 
160 122 
161 125 
162 126 


MAC page: 
>=0h] Eck --* 


21 0001 
c3 0OOCF' 


21 0000 


CA 0007! 
c3 0157! 


21 0055 


21 0057 
CD 0088" 
21 0008 


21 0008 
CD 0031' 
21 0001 
CD 0000 
CD 00E1' 
CD 0000 


21 0001 
21 0057 


21 0001 
CD 0000 


21 0001 
CD 0000 


CA 0137' 
21 016D' 


21 0002 


source 


LXI H,1 
JMP CC8 


AD 
CALL CCGCHAR#H 
PUSH H 
LXI H,8 
DAD SP 
PUSH H 
LXI H,8 
DAD SP 
CALL CCGINTAH 
XCHG; ; 
LXI H,1 
CALL CCSUBR#H 
POP D 


DAD D 
CALL CCGCHAR##H 


POP D 

CALL CCXOR## 
POP D 

MOV A,L 


PUSH H 

LXI H,1 
PUSH H 
CALL write 
POP B 

POP B 

POP B 
XCHG;; 

LXI H,1 
CALL CCNE## 
M 


ORA L 

32 Cc9 

LXI H,CC2+16 
PUSH H 

LXI H,2 
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: CPT.MAC 


page: 


OD Ject-* >> 


0068 ' 


0007 
0074! 


0002 


0004 
00EE"' 


0000 
0001 


0080 
0082' 


0056 


73 61 
20 43 
6B 65 
6F 75 
74 20 
6F 72 


4 


source 


PUSH H 
CALL fputs 
POP B 

POP B 

LXI H,7 
PUSH H 
CALL abort 
POP B 

CC9: 

LXI H,2 
DAD SP 
PUSH H 

LXI H,4 


DAD SP 

CALL CCGINT## 
XCHG; ; 

POP B 

POP H 

PUSH H 


PUSH B 
CALL CCDIVAR 


CALL CCPINTA# 
JMP CC4 

CC5: 

LXI H,86 

DAD SP 

SPHL 


RET 
CC2:DB 117,115,97,103,101,58,32,67,80,84 
DB 32,107,101,121,10,0,111,117,116,112 
DB 117,116,32,101,114,114,111,114, 10,0 


EXT 
EXT 
EXT 
EXT 
EXT 
EXT 
EXT 
EXT 
EXT 
END 


read 
isatty 
poll 
auxbuf 
abort 
fputs 
write 
getarg 
ulink 
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file: CPT.MAC page: 5 

134° ABORT#AH E! AUXBUF## 0° cc1: 15D' Cc2: 
77‘ Ccc3: 82! CC&4: 157' Cc5: D7' CC6: 
cc! Cc7: CF' CC8: 137' Cc9: 149° CCDIVAR 
BF! CCEOHA FA! CCGCHAR#A 141' CCGINTARH 118! CCNE## 
SB! CCOR#HH 152! CCPINTAR F5! CCSUB#A# FE' CCXOR#A 
12B' FPUTSAH 35! GETARG#A# AB! 1SATTYRR O' MAIN:: 
A3'! POLL#HH 90! READ#A# 0 ULINKAH 111' WRITEAR 


Damit ist die Assemblierung abgeschlossen. Sie finden nun auf der Diskette 
eine Datei mit dem Namen CPT.REL. Diese Datei enthält den erzeugten 
relokatierbaren Objektcode. Damit dieser als Programm laufen kann, muß 
er noch gelinkt werden. Linken bedeutet, daß alle für den Programmlauf 
benötigten Routinen aus der Bibliothek C.LIB hinzugefügt werden und 
dann ein unter CP/M aufrufbares Programm mit dem Namen CPT.COM 
daraus gemacht wird. 


Kopieren Sie dazu nun die Dateı CPT.REL auf die Diskette 3 (Linker) und 
geben Sie dann folgenden Befehl eın: 


A>LNK_-M CPT C.LIB 


Der Linker meldet mit seiner Startmeldung und gibt dann auf dem Bild- 
schirm aus, was er macht. Die Namen am Ende jeder Zeile sind die Namen 
der Programm-Module, die zum größten Teil aus der Bibliothek C.LIB 
hinzugebunden werden. 


Small-Mac Linkage Editor, Version X.X (Rev. XX) 


Copyright 1985 J. E. 


17B 


Bytes 
Bytes 
Bytes 
Bytes 
Bytes 
Bytes 
Bytes 
Bytes 
Bytes 
Bytes 
Bytes 
Bytes 
Bytes 
Bytes 
Bytes 
Bytes 
Bytes 
Bytes 
Bytes 
Bytes 
Bytes 
Bytes 


C Bytes 


Bytes 
Bytes 


D Bytes 

Start In END 
20E6 Bytes 
8422 Bytes 


at 
at 
at 
at 
at 


at 
at 
at 
at 


0° 
178! 
527° 
550! 
6F5' 
1819* 
186C ! 
18F8! 
I190C! 
19C1! 
1A4C! 
1A7E! 
1820! 
18CD! 
1C7E! 
1C8B ' 
ICED‘ 
ICFc® 
1D2B' 
1DAC’ 
1DF1° 
1E51* 
1EE4' 
IF20° 
2049 ' 
2009! 


(hex) 
(dec) 


103 
27E 
6A 
660 
7F8 
I91C 
196F 
19FB 


Hendrix 


CPT 
AUXBUF 
AVAIL 
CALL 
CSYSLI 
EXIT 
FCLOSE 
FEOF 
FFLUSH 
FGETC 
FPUTS 
FREAD 
FWRITE 
GETARG 
ISATTY 
ISSPAC 
MALLOC 
PAD 
POLL 
STRCHR 
STRCMP 
STRNCP 
TOUPPE 
CSEEK 
FPUTC 
END 
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Der Parameter -M beim Aufruf bedeutet wieder, daß der Linker bei der 
Arbeit Informationen über den Linkvorgang ausgeben soll. CPT ist der 
Name des zu linkenden Programms, auch hier wieder ohne Namenserweite- 
rung REL. C.LIB ist die Bibliothek, in der der Linker nach ım eigentlichen 
Programm nicht definierten Funktionen suchen soll. Nun ist das lauffähige 
Programm CPT.COM mit einer Größe von 8422 Bytes erzeugt worden. 
Bitte überzeugen Sie sich davon, indem Sie es nach den Anweisungen in 
Kapitel 5 auf eine Dateı anwenden. 


Kopieren Sie nun das Programm CPT.COM auf Ihre Anwendungsdiskette. 
Sıe können dann die Dateien CPT.C, CPT.MAC, CPT.REL und CPT.COM 
von den Disketten 1 bis 3 herunterlöschen, damit wieder Platz für einen 
weiteren Kompiliervorgang vorhanden ist. 


Diskettenaufteilung bei zwei Laufwerken 


Wenn Sie an Ihrem Computer zwei Laufwerke angeschlossen haben, ist der 
Kompiliervorgang etwas einfacher. Sie können dann die Programme 
PIP. COM, CC.COM, MAC.COM und LNK.COM sowie die C-Bibliothek 
(C:.LIB, C.NDX) auf der Diskette im Laufwerk A speichern, so daß das 
Laufwerk B für die Quelldateien (STDIO.H und CPT.C) verfügbar ist. 


Ein zweites Beispiel 


Damit die Vorgehensweise noch deutlicher wird, hier noch ein weiteres 
Beispiel. Es soll nun das Programm LST aus den Small-Tools kompiliert 
werden. Sehen Sıe sich dazu das Programm einmal an. Wie Sie sehen kön- 
nen, werden bei diesem Programm außer STDIO.H noch vier weitere 
Dateien mit der Anweisung #include eingeschlossen. Diese werden natürlich 
bei der Kompilierung auch benötigt. Kopieren Sie also zunächst die Da- 
teien LST.C, TOOLS.H, OUT.C, SAME.C und TRIM.C von der Diskette 
Sı auf die Diskette 1 (C-Compiler). 


Rufen Sıe nun den C-Compiler wieder mit dem Namen des Programms 
auf. 


A>CC_-M LST 


Der Compiler zeigt wıeder an, welche Funktionen er kompiliert. Nach der 
Reendigung haben Sie den Assemblercode in der Datei LST.MAC. Kopieren 
Sie diese auf die Diskette 2 (Small-Mac-Assembler). Rufen Sıe den Assem- 
bler nun wieder ähnlich wie eben auf, geben Sie aber statt des Listing- 
parameters -L den Parameter -NM an. Dieser Parameter bedeutet "keine 
Makros" ("No Macros"), der Compiler versteht dann also keine Makros 
mehr. Dies ist bei kompilierten C-Programmen auch nicht notwendig. Da- 
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für wırd die Assemblierung dann um etwa 13% schneller. Der Listing- 
parameter kann wegfallen, da ansonsten die Bildschirmausgabe die Assem- 
blierung unnötig bremst. Geben Sıe also ein: 


A>MAC_-NM_LST 
Der Assembler erzeugt die Datei LST.REL, die auf die Diskette 3 (Linker) 


kopiert werden muß. Hier rufen Sıe dann mit folgendem Befehl den Linker 
auf: 


A>LNK -M LST C.LIB 


Wenn der Linker seine Arbeit beendet hat, befindet sich auf der Diskette 
das lauffähige Programm LST.COM. 
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Kompilierung der Small-Tools 


Der Quellcode für jedes Small-Tools-Programm befindet sich ın der Datei 
gleichen Namens aber mit der Erweiterung C. EDT ist in zwei Teile ge- 
gliedert, EDT.C und EDT2.C (die zur Kompilierzeit in EDT.C eingebunden 
wird). FMT besteht aus drei Teilen: FMT.C, FMT2.C, und FMT3.C. Die 
letzteren beiden werden zur Kompilierzeit in die Datei FMT.C eingebun- 
den. Die restlichen C-Dateien sind allgemeine Funktionen, die in mehrere 
Small-Tools-Programme eingebunden werden. 


Alle #include-Anweisungen ın den Programmen gehen davon aus, daß die 
Include-Dateien auf dem Standardlaufwerk sind. Wenn man anders ver- 
fährt, muß man vor dem Kompilieren die #include-Anweisungen in den 
Programmen ändern. Man sollte sıch also vor dem Kompilieren das zu 
kompilierende Programm anschauen und sicherstellen, daß sich alle 
Include-Dateien auf dem entsprechenden Laufwerk befinden. Ansonsten 
kann so vorgegangen werden, wie es oben beschrieben wurde. Nur beı den 
Programmen EDT und FNT tritt eine kleine Änderung auf. Da diese Pro- 
gramme recht groß sınd, werden darin eine große Anzahl von Symbolen 
definiert, was dazu führt, das die Symboltabelle des Small-Mac-Assemblers 
überläuft. MAC muß also bei diesen beiden Programmen mit dem Schalter 
-S zur Vergrößerung der Symboltabelle aufgerufen werden, etwa so: 


MAC -NM -S800 EDT 


Änderung von Small-Tools- Parametern 


Zur Kompilierzeit schließen alle Programme die Dateien STDIO.H und 
TOOLS.H ein. STDIO.H ist Bestandteil des Small-C-Compilers und sollte 
ohne Änderung bei jedem Small-C-Programm benutzt werden. TOOLS.H 
hingegen wird nur mit den Small-Tools-Programmen benutzt und kann an 
die entsprechenden Erfordernisse angepaßt werden. Darin werden unter 
anderem definiert: 


l. dıe maxımale Länge einer Textzeile (MAXLINE), 

2. die Zeichenfolge, die den Bildschirm löscht (CLEAR), 

3. die Größe des Bildschirms (CRT..) und der Druckseite (PTR..) und 
4. welche Zeichen als Metazeichen dienen, 


Änderungen in dieser Datei müssen vor dem Kompilieren gemacht werden. 
Die Tastatur und die Anwendung bei der Textverarbeitung sind wesentliche 
Kriterien für die einfache Benutzung der Metazeichen. Man sollte sorg- 
fältıg darüber nachdenken, wıe man sie ändert und dann auch die Doku- 
mentation entsprechend ändern. 


”* 
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- Small -Tools definitions. 
%* 


* 


#define MAXFN 15 /* max file name space */ 
#define EXTMARK ı.ı /% file extension mark */ 
#define MAXLINE 192 /* max text line space */ 
/* WY-50, TV-920, HZ-1500, AD-VP */ 
#define CLEAR "\33\53" /* screen erase */ 
#define CRTWIDE 80 /* screen width */ 
#define CRTHIGN 24 /% screen height */ 
#define PTRWIDE 80 /* page width */ 
#define PTRHIGH 66 /* page height */ 
#define PTRSKIP 8 /* page perforation skips */ 
#define PTRHDR 2 /* page header lines */ 
#define MAXPAT 257 /* max pattern in internal format */ 
#define CHAR 'c!' /* identifies a character */ 
#define BOL ru /% beginning of line */ 
#define EOL ıy\ıUı /# end of line */ 
#define ANY ı71 /* any character */ 
#define CCL ı[! /%* begin character class */ 
#define NCCL It /% negation of character class */ 
#define CCLEND ı)ı /%* end of character class */ 
#define CLOSURE ı#ı /% zero or more occurrences */ 
#define DITTO ı70 /*% whatever string matches pattern */ 
#define ESCAPE .° /* escape character */ 
#define NOT '-ı /% negation character */ 
#Adefine DITCODE -3 
#define COUNT 1 
#define PREVCL 2 
#define START 3 
#define CLOSIZE 4 


Die Definition von CLEAR muß an den eigenen Computer angepaßt wer- 
den. CLEAR ist die Zeichenkette zum Löschen des Bildschirms und Posı- 
tionierung des Cursors in die linke obere Ecke. In der gelieferten Version 
ist sie für die angegebenen Computer bzw. Terminals vorgesehen. Die Zei- 
chen bedeuten eın Escape ("\33") und ein Plus ("\53"),;, die Zahlen sind 
oktale Werte. Wenn der Zielcomputer nun aber die Steuersequenzen des 
VT52-Terminals versteht, muß die Definition von CLEAR so lauten: 


Adefine CLEAR "\33E\33H" /* screen erase */ 


Dies bedeutet beim VT52, daß der Bildschirm gelöscht wird (ESC E) und 
dann der Cursor in die linke obere Ecke positioniert wird (ESC H). 


Die Zeilenzahl des Bildschirms wird mit CRTHIGH definiert. Meistens 
kann die Zahl 24 stehenbleiben, es gibt jedoch auch Microcomputer mit 25 
Bildschirmzeilen. Hier sollte der Wert entsprechend geändert werden. 


Die Definitionen, die mit PTR beginnen, beziehen sıch auf den Drucker. 
PTRWIDE ist die Anzahl der Spalten pro Zeile. PTRHIGH ist die Anzahl 
Zeilen pro Seite; dies sollte auf jeden Fall auf die in Deutschland übliche 
Länge von 72 Zeilen abgeändert werden. 
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Es folgen noch mehrere Zeichendefinitionen für die Angabe von Sonder- 
zeichen oder Zeichenklassen. Wenn der Zielcomputer den DIN-Zeichensatz 
verwendet, sind die Zeichencodes für "@f[\]{lJ-" identisch mit denen von 
sÄAÖUAöüß". Sollen also in den Parametern auch alle Umlaute verwendet 
werden können, müssen dıe Definitionen von CCL, NCCL, CCLEND und 
NOT auf jeden Fall geändert werden. Es empfehlen sich hier folgende Zei- 
chen: ’(’ statt °[’, ’)’ statt ’T und ’#’ statt ”-°. Es ist zu beachten, daß sich 
dann die Bedienung aller Small-Tools entsprechend ändert. 


Kompilierung der Quellprogramme 167 


Das Programm AR zur Verwaltung von Archivdateien 


Der Quellcode des Small-C-Compilers und der Small-C-Bibliothek wird 
wegen der großen Anzahl der Module in sogenannten Archivdateien aus- 
geliefert. Bevor der Compiler oder ein Bibliotheksmodul kompiliert werden 
kann, muß es aus der jeweiligen Archivdatei ın eine normale Datei heraus- 
kopiert werden. Der Quellcode des Small-C-Compilers befindet sich in der 
Archivdatei CC.ARC, der Quellcode der Bibliothek ın CLIB.ARC. 


Das Programm AR.COM dient dem Anlegen und der Verwaltung solcher 
Archivdateien. Damit können mehrere Textdateien in eine Archivdateı ko- 
piert, einzelne Module wieder herausgezogen, neue hinzugefügt und alte 
ersetzt oder gelöscht werden. Ebenso ist es möglich, den Inhalt einer 
Archivdateı anzuzeigen. AR wird wie folgt bedient: 


ar -(dptux} arcfile [file...] 


Das erste Argument ist einer der angegebene Schalter. Das zweiter Argu- 
ment ist der Name der Archivdatei. Als einzige Namenserweiterung ist 
ARC zugelassen. Sıe muß angegeben werden. Die weiteren Parameter sind 
Datei- oder Modulnamen. Die Schalter haben folgende Bedeutung: 


-d Löscht die angegebenen Module aus der Archivdatei. 

-D Gibt die angegebenen oder alle (ohne Namen) Module auf 
der Standardausgabe aus. 

-t Gibt eine Liste der Module in der Archivdateı auf der Stan- 
dardausgabe aus. 

u Aktualisiert die Archivdateı indem die genannten Module 


hinzugefügt oder durch neue ersetzt werden. Dieser Schalter 
wird auch zum Anlegen einer neuen Archivdateı verwendet. 
Wenn keine Dateinamen angegeben wurden, werden sıe von 
der Standardeingabe gelesen. 

-xX Die angegebenen oder alle (ohne Namen) Module werden 
aus der Archivdatei heraus in eigene Dateien kopiert. 


Beispiele 


BEFEHL BESCHREIBUNG 


AR -T CLIB.ARC 
Zeigt eine Liste aller Module in der Archivdatei CLIB.ARC 
an. 

AR -P CLIB.ARC ATOIB.C 
Gibt das Modul ATOIB.C aus der Archivdatei CLIB.ARC 
auf der Standardausgabe aus. 
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AR -X CC.ARC CC1.C 
Kopiert das Modul CC1.C aus der Archivdateı CC.ARC ın 
eine eigene Datei. 
AR -X CC.ARC 
Kopiert alle Module aus der Archivdateı CC.ARC ın eigene 
Dateien. 
AR -D CLIB.ARC ATOIB.C 
Löscht das Modul ATOIB.C aus der Archivdateı CLIB.ARC. 
AR -U CC.ARC CC.DEF 
Bringt die Datei CC.DEF in die Archivdateı CC.ARC. Wenn 
das Modul CC.DEF darin bereits existiert, wird die alte 
Version durch die neue ersetzt. 


Meldungen 
MELDUNG ERLÄUTERUNG 


copied neW XXXXXXXX 
| Die genannte Datei wurde ın die Archivdatei aufgenommen. 
printed xXXXXXxXxX 
Die angegebene Datei ist ausgedruckt worden. 
created XXXxXxXxXXX 
Die angegebene Datei ist angelegt worden. 
dropped old %s 
Die alte Version eines Moduls wurde durch eine neue Ver- 
sıon überschrieben. 
file - XXXXXXXX 
Die angegebene Datei wırd gerade verarbeitet. 


Fehlermeldungen 
MELDUNG ERLÄUTERUNG 


XXXXXXXX: can't open 
Eine Datei kann nicht geöffnet werden. 

fatal errors - archive not altered 
Es ist ein nicht behebbarer Fehler aufgetreten, die Archiv- 
datei wurde nicht geändert. 

can't rename xXxXxXxXXxXX TO XXXXXXXX 
Eine Datei kann nicht umbenannt werden. Wahrscheinlich 
befindet sich auf der Diskette bereits eine Dateı mit dem 
neuen Namen. 

delete by name only 
Bei der Option -d muß mindestens ein Modulname angege- 
ben werden. 


Kompilierung der Quellprogramme 169 


XXXXXXXX: can't create 
Eine Ausgabedatei für ein Modul, das aus der Archivdatei 
extrahiert werden soll, kann nicht geöffnet werden. Wahr- 
scheinlich ıst das Diskettenverzeichnis voll. 
too many file names 
Es sınd mehr als MAXFILES Dateinamen angegeben wor- 
den. Entweder weniger Dateien angeben oder AR.C mit 
einem höheren Wert für MAXFILES neu kompilieren. 
XXXXXXXX: duplicate file names 
Eine Datei wurde in der Befehlszeile mehrmals genannt. 
archive not in proper format 
Die angegebene Archivdatei hat kein gültiges Format. Ent- 
weder ist die Datei keine Archivdateı oder sie wurde durch 
einen Fehler zerstört. 
XXXXXXXX not in archive 
Das genannte Modul befindet sich nicht in der Archivdateı. 
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Kompilierung des Small-C-Compilers 


Das wichtigste am Small-C-Compiler ist, das er selbst in Small-C geschrie- 
ben ist und mit Quellcode ausgeliefert wird. Der Compiler ist selbst nur ein 
einfaches Small-C-Programm und kann deshalb verwendet werden, um 
neue Versionen von sich selbst zu erzeugen. Die Kompilierung des Small- 
C-Compilers unterscheidet sıch im wesentlichen nicht vom Kompilieren 
eines beliebigen anderen C-Programms. 


Der Compiler ist in vier Module aufgeteilt, das jedes für sich kompiliert 
wird. Alle vier Module werden dann mit dem Linker zu einem lauffähigen 
Programm zusammengebunden. Alternativ kann der Small-C-Compiler auch 
in einem Zuge kompiliert werden, dazu ist jedoch ausreichend Speicher er- 
forderlich. 


Die Module des Small-C-Compilers befinden sich in der Archivdatei 
CC.ARC und können mit dem Programm AR herauskopiert werden. Die 
Bedienung von AR ist im vorhergehenden Abschnitt beschrieben. 


Die Quelldateien fallen in drei Kategorien: 


l. Die Datei CC.DEF enthält alle #define-Anweisungen für den Compi- 
ler. Die meisten dieser Definitionen sind Symbole für Konstanten, ei- 
nige steuern jedoch auch die Kompilierung. Diese werden in Ver- 
bindung mit den Präprozessoranweisungen #ifdef, #ifndef, #else und 
#endif verwendet, um bestimmte Zeilen in die Kompilierung mit ein- 
zubeziehen oder davon auszuschließen. Sıe beeinflussen also, welche 
Eigenschaften im neuem Compiler enthalten sind. Eines dieser Sym- 
bole, SEPARATE, hat keinen Einfluß auf den erzeugten Compiler, 
sondern bewirkt, daß der Compiler in einzelnen Modulen kompiliert 
werden kann. 

2. Die Dateien CC1.C, CC2.C, CC3.C und CC4.C enthalten die Hauptteile 
des Compilers. CC1.C enthält die Deklarationen der globalen Objekte 
und die anderen Dateien enthalten externe Deklarationen derselben 
Objekte. Diese Deklarationen werden nur kompiliert, wenn SEPA- 
RATE definiert ist. Jede Hauptdatei enthält auch eine #include-An- 
weisung für STDIO.H. Schließlich enthält jeder Hauptteil noch 
#ınclude-Anweisungen für die weiteren Module des jeweiligen Com- 
pilerteils. CC1.C enthält zusätzlich noch weitere #include- Anweisungen 
für die Teile 2, 3 und 4. Diese Anweisungen werden jedoch nur aus- 
geführt, wenn SEPARATE nicht definiert ıst, der Compiler also in 
einem Zuge kompiliert wird. In diesem Fall braucht nur CC1 kompi- 
liert werden, sonst muß jeder Teil (CC1, CC2, CC3 und CC4) getrennt 
kompiliert werden. NOTICE.H enthält Copyright und Versionsnummer. 
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3. Die Dateien mit zwei Ziffern im Dateinamen sind Unterdateien der 
jeweiligen Hauptteile. Die erste Ziffer kennzeichnet den Hauptteil, zu 
dem die Datei gehört, die zweite Ziffer ist eine fortlaufende Nummer. 
Die folgende Tabelle zeigt die Verbindung der Dateien untereinander: 


Haupt- . . : 
Teil datei Schließt folgende Dateien ein 


1 CCI.C STDIO.H CC.DEF CCI1.C CC1I2.C CC1I3.C NOTICE.H 
2 CC2.C STDIO.H CC.DEF CC21.C CC22.C 

3 CC3.C STDIO.H CC.DEF CC31.C Cc32.C CC33.C 

& CC4.C STDIO.H CC.DEF CC41I.C CC42.C 


Um verschiedene Compiler-Optionen zu kontrollieren, sind mehrere Sym- 
bole ın der Datei CC.DEF definiert worden. Die wichtigsten werden ım 
folgenden erläutert. 


Das Symbol DYNAMIC kompiliert Anweisungen, die dynamisch Speicher 
für verschiedene Tabellen und Arrays ınnerhalb des Compilers anlegen. 
Wenn DYNAMIC nicht definiert ist, werden die Tabellen und Arrays di- 
rekt ım Compiler angelegt. Dieses Symbol kontrolliert auch Anweisungen, 
dıe CCAVAIL aufrufen, deren prımärer Zweck ıst, den verfügbaren freien 
Speicherplatz zurückzugeben. Es wırd aber benutzt, um sicherzustellen, daß 
sich Stack und zugeordneter Speicher nıcht überlappen. Wenn serielle Ta- 
bellensuche zusammen mit dynamischer Speicherzuordnung benutzt wird, 
wird jede neue Eintragung in der globalen Symboltabelle separat zugeord- 
net. Diese Tabelle kann wachsen, bis sie den Maschinenstack überlappt und 
dann einen Zuordnungsfehler produziert. 


LINK setzt voraus, daß die Compilerausgabe mit einem verschiebbaren 
Assembler und einem Linker weiıterverarbeitet wırd. Als extern deklarierte 
globale Variablen werden als externe Referenzen und andere globale Varia- 
blen als Einsprungspunkte kompiliert. In diesem Fall können mehrteilige 
Programme nicht während des Assemblierens kombiniert werden und die 
Startlabel-Option (-B# Schalter) ist nicht verfügbar. 


Durch die Definition von COL werden Label in der Ausgabe durch einen 
Doppelpunkt beendet. 


Wenn UPPER definiert ist, werden Symbole ın Großbuchstaben in die 
Symboltabelle eingetragen. Wenn das der Assembler nicht erfordert, sollte 
die Definition von UPPER ausgeschaltet werden. 


NOCCARGC ıst eine Laufzeit-Option, die dem Compiler sagt, daß er kei- 
nen Code zur Übergabe der Zahl der: Argumente erzeugen soll. Als Ergeb- 
nıs erhält man kleınere, schnellere Programme, wenn bekannt ıst, daß kein 
Aufruf zur Laufzeitroutine CCARGC erfolgt. 
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SEPARATE setzt voraus, daß der Compiler in Teilen kompiliert werden 
soll, anstatt in einem. In diesem Fall müssen die Dateien CC1.C, CC2.C, 
CC3.C, und CC4.C getrennt kompiliert werden. Diese wiederum enthalten 
untergeordnete Dateien; zum Beispiel CC11.C, CC12.C und CC13.C (für 
Teil 1). Wenn dieses Symbol fehlt, dann schließt die Datei CC1.C alle 
untergeordneten Dateien ein und CC2.C, CC3.C und CC4.C werden nicht 
benutzt. 


Vier Symbole erlauben es zu bestimmen, welche Sprachanweisungen durch 
den neuen Compiler unterstützt werden. Man kann sie auslassen, um den 
Compiler so klein zu machen, daß er selbst komplett auf einer Maschine 
mit weniger als 56 KByte kompiliert werden kann. 


STDO kontrolliert die do-Anweisung. STFOR kontrolliert die for-Anwei- 
sung. STSWITCH kontrolliert die Anweisungen switch, case und default. 
STGOTO kontrolliert die Anweisung goto. Diese Definitionen verbinden 
mit jeder Anweisung auch einen numerischen Wert; der Compiler benutzt 
dies, um zu entscheiden, ob die letzte Anweisung in einer Funktion ein 
return ist. 


Durch die Definition von OPTIMIZE wird die Peephole-Optimierung ein- 
geschlossen. Die Optimierungstechniken werden im folgenden für interes- 
sierte Anwender beschrieben. 


Beschreibung der Codeoptimierung 


Maschinenunabhängige Optimierung wird durch eine Änderung des Aus- 
drucksanalysierers, maschinenabhängige Optimierung durch eine wahl- 
weisen Ausgabeoptimierung (peephole) erreicht. 


Die maschinenunabhängige Optimierung benutzt folgende Techniken: 


l. Ausdrücke oder Teilausdrücke, die als Ergebnis einen konstanten Wert 
haben, erzeugen nur eine einzigen direkten Ladebefehl. 

2. Nachdem der Code auf der rechten Seite eines binären Befehls erzeugt 
wurde, wird das vorsichtshalber vorgenommene push/pop der rechten 
Seite durch einen Tausch ersetzt, wenn das Zweitregister nicht benutzt 
worden war. Wenn aber der Wert auf der linken Seite eine Konstante 
ist, wird sıe stattdessen sofort in das Zweitregister geladen. 

3. Konstanten, die von Integerzeigern oder Arrays addiert oder subtra- 
hiert werden, werden bereits durch den Compiler verdoppelt und nicht 
erst während der Ausführung. 

4. Für die Anweisungen if(const), while(const), und for(...: const; ...) 
wird kein geschachtelter Code erzeugt. Der Compiler kümmert sich 
nicht um die Löschung dieser Codesequenzen, da es sich wahrschein- 
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lıch um einen Programmfehler handelt; #ifdef und #ifndef sollten 
verwendet werden, um bedingten Code während des Kompilierens zu 
entfernen. 

5. Prüfung auf Null (zum Beispiel while(i >= 0) oder iffabc() == 0) und 
so weiter) ergibt eine besondere Codefolge, die kleiner und schneller 
ist, als die übliche Prozedur Null zu laden, eine Bibliotheksroutine 
aufzurufen und dann den zurückgegebenen Wert auf 0 oder I zu 
testen. 

6. Nullwerte erzeugen keinen Code zur Addition mit Arrayadressen und 
Zeigerwerten. 

7. Lokale Variablen werden alle zusammen zur gleichen Zeit zugeordnet, 
wenn die erste ausführbare Anweisung angetroffen wird. Deklarationen 
nach diesem Punkt sind nicht erlaubt, außer innerhalb innerer Blöcke. 

8. Unnötige Sprünge um Anweisungen, die durch e/se kontrolliert wer- 
den, werden vermieden. Dies ıst der Fall, wenn ein return oder 20to 
dem else vorausgeht. 

9. Die Funktion modstk erzeugt jetzt zwei Vertauschungen, um das Erst- 
register nur bei einem return mit einem Wert zu erhalten. 


Maschinenabhängige Optimierung wird durch die zwei Funktionen, putstk 
und peephole, erreicht. Putstk erzeugt jetzt anstatt CALL CCPCHAR die 
Befehlsfolge MOV A,L/STAX D. Peephole ist die schon erwähnte Aus- 
gabeoptimierung. Für den durch einen Ausdruck erzeugten Code wird ein 
Puffer benutzt. Wenn der Puffer zurückgeschrieben wird, untersucht peep- 
hole() die Ausgabe und macht passende Änderungen. Die Ausgabeoptimie- 
rung ist eine Compiler-Option, die manche für ein getrenntes Hilfspro- 
gramm besser geeignet finden. Ich fand es jedoch unwiderstehlich, diese 
einfache Funktion dem Compiler huckepack aufzuladen; man kann dadurch 
einfacher und leichter optimiert kompilieren. 


Peephole( ) benutzt zwei Techniken. Erstens werden Integer von der Spitze 
des Stacks mit einer POP H/PUSH H Sequenz geholt anstatt mit der übli- 
chen Sequenz LXI H,0/DAD SP/CALL CCGINT. Integer direkt unterhalb 
der Stack-Spitze werden mit der Sequenz POP B/POP H/PUSH H/PUSH B 
gelesen. Wenn ein XCHG dem Lesezyklus folgt, wird der gewünschte Ope- 
rand direkt ın das DE-Registerpaar geladen. Dadurch erhält man schnelle- 
ren und kompakteren Code; dies ist immer wirksam, wenn der Compiler 
peephole( ) enthält. 


Die zweite Technik ersetzt oft benutzte Befehlssequenzen durch neue Ein- 
sprungspunkte in die Laufzeitbibliothek. Diese Technik reduziert die Pro- 
grammgröße auf Kosten der Geschwindigkeit; sie muß beı der Laufzeit an- 
gefordert werden (-0), um wirksam zu sein. 


174 Kompilierung der Quellprogramme 


Übergabe der Argumentzahl 


Wenn eine Funktion aufgerufen wird, wird die Zahl der zu übergebenden 
Argument in den Akkumulator gestellt. Dies benötigt nur zwei Bytes. Um 
die Zahl zu holen, weist die aufgerufene Funktion einer Variablen einfach 
den von der Funktion CCARGC (Großbuchstaben) zurückgegeben Wert zu. 
Dies muß als erstes in der Funktion gemacht werden, da andere Opera- 
tionen Laufzeitbibliotheken aufrufen können, die den Akkumulator zer- 
stören. CCARGC ist ein neuer Einsprungspunkt in der Laufzeitbibliothek; 
sie definiert einfach CCSXT neu, die A mit Vorzeichen nach HL bringt. 
Damit hat man 127 Argumente, bevor das Programm abstürzt. Aus offen- 
sichtlichen Gründen erzeugt der Compiler keinen Code, um die Anzahl der 
Argument zu laden, wenn CCARGC aufgerufen wird. Da viele Programme 
die Zahl der Argumente nicht übergeben, übergeht der Compiler dies in 
Programmen, die die Anweisung #define NOCCARGC (Großbuchstaben) 
enthalten. Dies reduziert Prpgrammgröße und Ausführungszeit. 
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Kompilierung der Small-C-Bibliothek 


Die Module der Small-C-Bibliothek befinden sıch ın der Archivdateı 
CCLIB.ARC und können mit dem Programm AR herauskopiert werden. 
Die Bedienung von AR ıst in einem vorhergehenden Abschnitt beschrieben. 


Für die Kompilierung auf Systemen mit wenig Speicherplatz ıst es am gün- 
stigsten, wenn das gewünschte Modul einzeln aus der Archivdateı heraus- 
kopiert und bearbeitet wird. Wenn alle Änderungen korrekt durchgeführt 
worden sind, muß das nach Kompilierung und Assemblierung entstandene 
REL-Modul mit LIB in die Bibliothek C.LIB eingebunden werden, damit 
es wirksam wird (bei Verwendung des Microsoft-Assemblers in dıe Biblio- 
thek CLIB.REL). Das fertige Quellmodul sollte mit AR wieder in die 
Archivdateı CLIB.ARC aufgenommen werden. 


Folgende Module befinden sich in der Archivdatei CLIB.ARC: 


ABS.C FSCANF.C MALLOC.C 
ATOI.C FWRITE.C OTOI.C 
ATOIB.C GETARG.C PAD.C 
AUXBUF.C GETCHAR.C POLL.C 
AVAIL.C ISALNUM.C PUTCHAR.C 
CALL.MAC ISALPHA.C PUTS.C 
CALLOC.C ISASCII.C RENAME.C 
CLEARERR.C ISATTY.C REVERSE.C 
CLIB.DEF ISCNTRL.C REWIND.C 
CSEEK.C ISCONS.C SIGN.C 
CSYSLIB.C ISDIGIT.C STDIO.H 
CTELL.C ISGRAPH.C STRCAT.C 
DTOI.C ISLOWER.C STRCHR.C 
EXIT.C ISPRINT.C STRCMP.C 
FCLOSE.C ISPUNCT.C STRCPY.C 
FEOF.C ISSPACE.C STRLEN.C 
FERROR.C ISUPPER.C STRNCAT.C 
FFLUSH.C ISXDIGIT.C STRNCMP.C 
FGETC.C ITOA.C STRNCPY.C 
FGETS.C ITOAB.C STRRCHR.C 
FOPEN.C ITOD.C TOASCII.C 
FPRINTF.C ITOO.C TOLOWER.C 
FPUTC.C ITOU.C TOUPPER.C 
FPUTS.C ITOX.C UNGETC.C 
FREAD.C LEFT.C UNLINK.C 
FREE.C LEXCMP .C UTOI.C 
FREOPEN.C LINK.MAC XTOI.C 
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Kompilierung der Small-Mac-Programme 


Bei den Small-Mac-Programmen wird weniger mit Include-Dateien gear- 
beitet als beim Compiler oder den Tools. Dafür befinden sich mehrere Mo- 
dule ın der Bibliothek M.LIB. Dies sind die Module, die von allen oder 
mehreren Programmen benötigt werden. Jedes Programm muß also nach 
dem Kompilieren außer mit C.LIB auch mit M.LIB gelinkt werden. Dabei 
ist es wichtig, daß M.LIB beim Aufruf des Linkers zuerst genannt wird, da 
darın Routinen aus C.LIB verwendet werden, die ansonsten beim Durch- 
suchen von C.LIB noch nicht definiert wären. Der Aufruf sieht so aus: 


LNK -M PRG M.LIB C.LIB 


Hier eine Übersicht darüber, welche Dateien mit #include in welche Pro- 
gramme eingeschlossen werden (STDIO.H ist nicht berücksichtigt): 


Programme: 
CMIT.C NOTICE.H MAC.H MIT.H 
DREL.C NOTICE.H MAC.H L.H 
LGO.C NOTICE.H 
LIB.C NOTICE.H REL.H 
LNK.C NOTICE.H REL.H 
MAC.C NOTICE.H MAC.H MIT.H REL.N 
MAC2.C MAC .H REL.H  EXT.H 
MAC3.C MAC.H REL.H EXT.H 
Bibliotheksmodule: 
EXTEND.C MAC.H 
FILE.C 
GETREL.C MAC.H REL.H 
INT.C 
MESS.C 
MIT.C MAC.H 
PUTREL.C MAC.H REL.H 
REL.C 
REQ.C 
SCAN.C MAC.H 
SEEREL.C REL.H 
WAIT.C 


Bei Änderungen an Bibliotheksmodulen müssen die entstehenden REL-Da- 
teien mit LIB in die Bibliothek M.LIB gebracht werden; die alten Versio- 
nen der Module werden dabeı überschrieben. 


Die Kompilierung der Programme CMIT, DREL, LGO, LIB und LNK geht 
so vor Sich, wie zu Beginn dieses Kapitels an anderen Beispielen beschrie- 
ben. Die Kompilierung des Small-Mac-Makorassemblers MAC ist etwas an- 
ders. Hier werden die Teile MAC, MAC2 und MAC3 seaparat kompiliert 
und anschließend mit dem Linker zusammengebunden. Die entstandene 
COM-Datei (MAC.COM) muß mit CMIT noch an den Befehlssatz des 8080 
oder Z80 angepaßt werden (CMIT mit dem Schalter -C aufrufen). Dazu 
muß sıch auf der Diskette auch die Dateı 8080.MIT oder Z80.MIT be- 
finden. Erst dann ist der Makroassembler lauffähig. 
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Anhang A: Patch von CP/M 2.2 für Kleinbuchstaben 


Mehrere Programme von Small-Tools verlangen ın der Befehlszeile Text- 
muster als Argumente. Unglücklicherweise wandelt der CCP von CP/M alle 
Kleinbuchstaben ın Großbuchstaben um und macht damit alle Versuche 
zunichte, Kleinbuchstaben anzugeben. Dies gilt genauso für SUBMIT.COM. 


Mit den folgenden Patches kann man alle Möglichkeiten der Small-Tools- 
Programme voll nutzen, außerdem kann man dann Dateinamen mit Klein- 
buchstaben angeben. Bei Small-C-Programmen werden die Dateinamen 
immer ın Großbuchstaben umgewandelt, PIP erwartet jedoch, daß dies der 
CCP macht. Gelegentlich gibt es deshalb bei PIP Ärger mit den Kleinbuch- 
staben. Deswegen und weil Laufwerksangaben und eingebaute Befehle ın 
Großbuchstaben erscheinen müssen, ıst es am besten, wenn man die Tasta- 
tur auf Großbuchstaben eınstellt (CAPS LOCK), außer wenn man Text- 
muster eingeben oder mit dem Editor arbeiten will. Schalter, die an die 
Small-Tools-Programme übergeben werden sollen, können entweder ın 
Klein- oder in Großbuchstaben angegeben werden. 


Die Patches sınd hıer ın der Version für den Schneider CPC 664 beschrie- 
ben, die genannten Adressen können bei anderen Systemen abweichen. 


Patch des CCP für Kleinbuchstaben mit MOVCPM, DDT und SYSGEN. 
Zunächst müssen mit MOVCPM die Betriebssystemspuren in eine Dateı 
kopiert werden. Beim Schneider CPC 664 erfolgt dies mit: 


MOVCPM 179 * 
SAVE 34 CPM44.COM 


Das Betriebssystem steht nun in der Datei CPM44.COM. Diese Datei wird 
nun mit DDT geladen und nach folgender Befehlsfolge durchsucht: 

0ABO CP 61 

0AB3 CPI 7B 


DAB6 ANI 5F <--- 
 D0ABß RET 


Es muß der Wert SF bei AB7h ın FF geändert und die Dateı mit dem oben 
genannten SAVE-Befehl wieder auf die Diskette geschrieben werden. Mit 
SYSGEN kann das CP/M dann wieder auf die Systemspuren zurückge- 
schrieben werden: 


SYSGEN CPM44 .COM 
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Patch von SUBMIT.COM für Kleinbuchstaben. 


SUBMIT.COM wird mit DDT geladen und nach dem folgenden Code 
durchsucht: 


0362 LDA 0675 
61 


0367 CPI 1A 

0369 JNC 0374 
036C LDA 0675 
036F AN) 5F <--- 
0371 STA 0675 
0374 LDA 0675 


Der Wert 5F bei 370h muß in FF geändert werden. Dann verläßt man DDT 
und speichert das geänderte SUBMIT mit folgendem Befehl auf der Dis- 
kette: 


SAVE 5 SUBMIT.COM 
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Anhang B: Bedienungshinweise der Programme 


usage: CC L[filel... CM C-AJ [-PJ] C-L#] [-0] [-BA 
usage: AR -{dptux) arcfile [file...] 


usage: MAC L[-L) [-NM) [-P] [-S#] [object] source... 
usage: LNK L[-BJ) L[L-G] [-M] program [module/library...) 
usage: LGD L[-GJ [-M] program 

usage: LIB -{DPTUXILA) library [module...] 

usage: CMIT [-C) [-L]J [table] [mac] 

usage: DREL 


usage: CHG pattern [replacement] 

usage: CNT Lfile]) L[-C[-W|-L) 

usage: CPY Lfilel... [.?] C-B] [-NCR)I C-NLF] [-T#,# 
usage: CPT key 

usage: DTB [#)... [(+#) 

usage: EDT L[file] [-V) 

usage: ETB L[#... [+#) 

usage: FND [-Jpattern 

usage: FNT [device] 


usage: FMT_ L[mergefile) [-BC#) [-EC#) L[-BP#) L-EP#] 
ö [- PO#] E-NPJ L-T) [-1] [-UJ [-SJ [-BS#) NR] 


usage: LST Lfile) [-C#) L-PW#l L-PL#) [-NB] E-NN] [NP] 

usage: MRG file [file] [-1|-2|-3|-F} 

usage: PRT _ Lfilel.. [.?) [L-NNJ E-NH|-NSI [-LM#) [-BP# c-ep#) [-P] E-NRI 
usage: SRT L-C#|-F#9) C-0) C-UJ CTX] 0 

usage: TRN L[-]from [to] 
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Anhang C: Übersicht aller Small-C-Funktionen 


Die Parameter der Funktionen in der folgenden Übersicht haben folgende 


Bedeutung: 


Parameter 


abort 
addar 
argl 
arg2 
argc 
argv 
base 
c 

cl 

c2 

ch 
cnt 
dest 
errcode 
fa 
mode 
n 
name 
nbr 
new 
old 
pause 
ptr 
size 
sour 
str 
strl 
str2 
SZ 


englisch 


address 

argument |] 
argument 2 
argument count 
argument variables 


character 
character I 
character 2 
character 
count 
destination 
error code 
fıle descriptor 


number 


number 


pointer 


source 
string 
string ] 
string 2 
sıze 


deutsch 


Abbruchcode 
Speicheradresse 
Argument I 
Argument 2 
Argumentzähler 
Argumentvariablen 
Basis 

Zeichen 
Zeichen | 
Zeichen 2 
Zeichen 

Zähler 
Zielstring 
Fehlercode 
Dateideskriptor 
Modus 

Anzahl 
Dateiname 

Zahl 

Neuer Dateiname 
Alter Dateiname 
Pause 

Zeiger 

Größe 
Quellstring 
String 

String | 

String 2 

Größe 
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abs(nbr) int nbr; 
atoi(str) char *str; 
atoib(str, base) char *str; int base; 
auxbuf(fd, size) int fd, size; 
avail(abort) int abort; 
calloc(nbr, sz) int nbr, sz; 
clearerr(fd) int fd; 
cseek (fd, offset, from) int fd, offset, from; 
ctell(fd) int fd; 
dtoi(str, nbr) char *str; int *nbr; 
exit(errcode) int errcode; (alias abort) 
fclose(fd) int fd; 
feof(fd) int fd; 
ferror(fd) int fd; 
fflush(fd) int fd; 
fgetc(fd) int fd; (alias getc) 
fgets(str, sz, fd) char *str; int sz, fd; 
fopen(name, mode) char *name, *mode; 
fprintf(fd,str,argl,arg2, ...) int fd; char #str; 
fputc(c, fd) char c; int fd; (alias putc) 
fputs(str, fd) char *#str; int fd; 
fread(ptr,sz,cnt,fd) char *ptr; int sz, cnt, fd; 
free(addr) char *addr; (alias cfree) 
freopen(name, mode, fd) char *name, *mode; int fd; 
fscanf(fd, str, argl, arg2, ...) int fd; char *#str:; 
fwrite(ptr,sz,cnt,fd) char *ptr; int sz, cnt, fd; 
getarg(nbr,str,sz,argc,argv) 
char *str; int nbr, sz, argc, *argv; 
getchar() 
gets(str) char *str; 
isalnum(c) char c; 
isalpha(c) char c; 
isascii(c) char c; 
isatty(fd) int fd; 
iscntrl(c) char c; 
iscons(fd) int fd; 
isdigit(c) char c; 
isgraph(c) char c; 
islower(c) char c; 
isprint(c) char c; 
ispunct(c) char c; 
isspace(c) char c; 
isupper(c) char c; 
isxdigit(c) char c; 
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itoa(nbr, str) int nbr; char *str; 

itoab(nbr, str, base) int nbr; char *str; int base; 
itod(nbr, str, sz) int nbr, sz; char *str; 
itoo(nbr, str, sz) int nbr, sz; char *#str; 
itou(nbr, str, sz) int nbr, sz; char *str; 
itox(nbr, str, sz) int nbr, sz; char *#str; 
left(str) char *str; 

lexcmp(strl, str2) char *strl, *str2; 

lexorder (cl, c2) char cl, c2; 

malloc(nbr) int nbr; 

otoi(str, nbr) char *str; int *nbr; 

pad(str, ch, n) char *#str, ch; int n; 
poll(pause) int pause; 

printf(str, argl, arg2, ...) char *str; 
putchar(c) char c; 

puts(str) char *str; 

read(fd, ptr, cent) int fd, cnt; char *ptr; 
rename (old, new) char *old, *new; 

reverse(str) char *str; 

rewind(fd) int fd; 

scanf(str, argl, arg2, ...) char *#str; 

sign(nbr) int nbr; 

strcat(dest, sour) char *dest, *sour; 
strchr(str, c) char *#str, c; 

strcmp(strl1, str2) char *strl, *str2; 

strcepy (dest, sour) char *dest, *sour; 
strlen(str) char *str; 

strncat(dest, sour, n) char *dest, *sour; int n; 
strncnp(strl, str2, n) char *strl, *str2; int n; 
strncpy (dest, sour, n) char *dest, *sour; int n; 
strrchr(str, c) char *str, c; 

toascii(c) char c; 

tolower(c) char c; 

toupper (c) char c; 

ungetc(c, fd) char c; int fd; 

unlink(name) char *name; (alias delete) 

utoi(str, nbr) char *str; int *nbr; 

write(fd, ptr, cent) int fd, cnt; char *ptr; 
xtoi(str, nbr) char *str; int *nbr; 
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Anhang D: Maschinen-Instruktions- Tabellen 


Maschinen-Instruktions- Tabelle für 8080 


slelolelklchnla 


ANA BICJOJEIHIL IM[A 
N 


CMC 
CMP B|C|DJE|H|L |MJA 
CNC x 


CE x1 A 

88 ADC B 
80 Ar B 
C6_x1 A 

AO 

E6_x1 ANI x 
CD _x2 CALL 
DC_x2 CC x 
FC x2 CM x 
er CMA 
3F 

B8 

D4 x2 

C4_ x2 CNZ x 
FA x2 CP x 
EC_x2 CPE x 
FE_x1 CPI x 
E4_x2 CPO x 
CC _x2 CZ x 
27 DAA 
39 DAD S 
19 DAD D 
29 DAD H 
09 DAD B 
3D DCR A 
05 DCR B 
OD DER C 
15 DCR D 
1D DCR E 
25 DER H 
2D DCR L 
35 DCR M 
DB DCX B 
1B DCX D 
2B DCX H 
3B DCX S 
F3 DI 

FB El 

76 HLT 
DB x1 IN x 
3C INR A 
04 INR B 
OC INR C 
14 INR D 
IC INR E 
24 INR H 
2C INR L 
34 INR M 
03 INX B 
13 INX D 
23 INX H 
33 INX S 


x 


"vo 


vo 
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= 


zrzmonwm>2ZZrzmpn>mo> DWöoOz 


au a1 2 1 12 122 0 2 v2 2 1 vv my nr nm 


ORA 
ORA 
ORI 
OUT 


PCHL 
POP B 
Pop D 
POP H 


x 


POP PSW 
PUSH H 
PUSH D 
PUSH B 


us ns 


KKRERRTKKRTKDIPDIDIDIDIDIDOIM IT HKXr X 


% 


2 rzmpnmpmo> 


PUSH PSW 


RAL 
RAR 
RC 

RET 
RIM 
RLC 
RM 

RNC 
RNZ 
RP 

RPE 
RPO 


oa u 2 1 12 1 m 


O0 99INRNNINIZTPrT 


z rzmpnp2>mo> 





2. 


 .- .- 2. ı nn ı. .- -> >. 


9 DOODOODOD>DSZEZ 


.- 2. un. n- .- » % 


m mmmmmmm >> 





z rzmpovn> OD» 


L co 
BIc[ojejH 
x 
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RRC 
RST O 
RST 16 
RST 24 
RST 32 
RST 40 
RST 48 
RST 56 
RST 8 
RZ 


sBB B|C|DJE|H|LIMIA 
SBI x 

SHLD x 

SIM 

SPHL 

STA x 

STAX B 

STAX D 


STC 
SUB BICIDIEIHILIMIA 
SUI x 


XCHG 
XRA BIC[DJEIH|L|MJA 
XRI x 

XTHL 
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Maschinen-Instruktions-Tabelle für Z80 


DD BE xI ADC A,CiKen) 

FD BE XI ADC A,(1Y 

88” ADC A:BlA, Ela, D|A,EJA,HJA,L|A,CHL)|A,A 
CE_x1 ADC A,x 

ED 4A ADC HL,BC 

ED_SA ADC HL,DE 

ED_6A ADC HL,HL 

ED_7A ADC HL,SP 


DD’86 xI ADD A, (1x) 

FD_86 xl ADD A,(1Y 

80 ADD A "Bla, la, D|A,EJA,HJA,L|A,CHL)[A,A 
6 x1 ADD A,xX 


09° ADD HL, "BC 
19 ADD HL,DE 
29 ADD HL,HL 
39 ADD HL,SP 
DD_09 ADD IX,BC 
DD 19 ADD IX,DE 
DD 29 ADD 1X, 1X 
DD 39 ADD IX,SP 
FD-09 ADD IY,BC 
FD_19 ADD IY,DE 
FD 29 ADD IY,IY 
FD 39 ADD IY,SP 


DD_A6_x1 AND (IX+x) 


FD_A6_x1 AND (IY+x) 
AO AND BICIDIEIHIL|CHLY JA 
E6_x1 AND x 


DD_CB_x1_46 BIT 
FO”CB x1 46 BIT 
CB 40” BIT 
DD-CB_x1_4E BIT 
FD_CB_x14E BIT 
CB4B 
DD-CB_x1 56 BIT 
FO_CB_x156 BIT 
CB 50 


DD_CB_x1_SE BIT 
FD_CB_x15E BIT Y+x) 
CB-58” BIT 3,013,013,E13,#13,113, chL 3 |3,A 


0,(1X+x) 
0,(1 
0,8] 
1, 
1,01 
1,B] 
2, 
2,(l 
zb] 
3,( 
2 
DD CB x1 66 BIT A 
4,01 
4.8] 
5,( 
5,(] 
2.8 | 
6,( 
6,(1 
se 
7,( 
7, 
7,B| 


Y+x) 
0,C]0,0[0,E10,4]0,1]0, CHL3]0,A 
X+x 
Y+x) 
EC DIELTHEISEITCHEIINEA 
K+x 


Y+x) 
BEIDE IZEHISEEISSCHL I 2A 
X+x 


FD_CB_x1_66 BIT Y+x) 

CB_60 &,C16,DI4,E14,H]4,L 14, (HL) |4,A 
DD_CB_x1_6E BIT X+x 

FD_CB_x1_6E BIT 
CB68 — 
DD"CB_x1_76 BIT 
FD_CB_x1_76 BIT 
B_70 


C 
DD CB_x1 7E BIT 
FD_CB_x1_7E BIT 


Y+x) 
SEM EIS EHEI A 
X+x 
Y+x) 
sE E01 SEI SMIS-L SEND SA 
X+x 


Y+x) 
7,c|7,0]7,E|7,#4]7,.]7,(cHL)]7,A 


cB_78 BIT 
DC x2 CALL C,x 
FC"x2 CALL M,x 
D4_x2 CALL NC,x 
C4 x2 CALL NZ,x 
F4_x2 CALL P,x 
EC’x2 CALL PE,x 
E4_x2 CALL PO,x 
CC_x2 CALL Z,x]|x 
F CCF 


DD BE x1 CP (1X+x) 
FD BE x CP (I1Y+x) 
BB” CP BICIoJEIHIL|cHLJ JA 


CP x 
CPD 
CPDR 
CPI 
CPIR 
CPL 


DAA 

DEC (HL) 
DEC (1X+x) 
DEC (1Y+x) 
DEC A 
DEC B 
DEC B 
DEC C 
DEC D 
DEC D 
DEC E 
DEC H 
DEC HL 
DEC IX 
DEC IY 
DEC L 
DEC SP 
DI 
DJNZ p 


El 
EX (SP),HL 
EX (SP),IX 
EX (SP),IY 
EX AF,AF' 
EX DE,HL 
EXX 


HALT 


vs 
z 
TTzZzmonm>»>N-O 


L 
INC SP|CHL) 


INDR 
INI 
INIR 


JP (HL) 
JP (IX) 
JP (IV) 
JP C,x 
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x1 


x] 


(BC),A 
(DE),A 


(HL),A 
(HL),BICHL),C|CHL),D[CHL),EICHL),H|CHLY,L 


(HL),x 
(1X+x),A 
(1X+x),B 
(1X+x),E 
(1IX+x),xX 
(1Y+x),A 
(1Y+x),B 
(1Y+x),E 
(IY+x),x 
(x),BC 
(x) ,DE 
(x),HL 


+ 
x 
= 


+x 


— bu) bu 
nn —<x 


+ 
Y+x) 


X+x) 


x) 


X+x) 


X+x) 


(IX+x) „C|CIX+x),D 
(IX+X),HICIX+X) L 


sen 
(IY+x),H 


(IY+x),D 
(IY+x),L 


) 
‚c|8,D[B,E|B,H|B,L|B,CHL)|B,A 


c,cic,ojc,Ejc,H|jc,Lic,cHL)|c,A 


+x) 
D,C[D,D|D,E|D,H|D,L|D,CHL)]D,A 


+x) 
E,CjE,D|E,EJE,HJE,L[E,CHL)JE,A 


+x) 
H,C|H,D|H,E|H,H|H,L|H,CHL) |H,A 





DD_ 21 x2 
FD_2A_x2 
FD21x2 
DD6E x1 
FD6E_x1 


DD_B6 _x1 
FD_B6_x1 
BO 


DD_CB_x1_86 
FD CB x1 86 
CB 80° — 
DD_CB_x1_B8E 
FD_CB_x1_8E 
CB_88 

DD CB x1 96 
FD CB x1 96 
cB 90 ° 
DD_CB_x1_9YE 
FD CB x1 9E 
cB 98 
DD_CB_x1_A6 
FD_CB_x1 A6 
CB_AO 
DD_CB_x1_AE 
FD CB x1AE 


LDI 


NEG 
NOP 


OR 


OR (I1Y+x) 
BICIDJEIHILICHLY A 
x 


OR 

OR 

OTD 
OTI 
OUT 
OUT 
OUT 
OUT 
OUT 
OUT 
OUT 
OUT 
OUT 
OUT 


POP 
POP 
POP 
POP 
POP 
POP 


PUS 
PUS 
PUS 
PUS 
PUS 
PUS 


RES 
RES 
RES 
RES 
RES 
RES 
RES 
RES 
RES 
RES 
RES 
RES 
RES 
RES 
RES 
RES 
RES 


IX,x 


IY,x) 


IY,x 


L,(CIX+x) 


L,( 


‘ 
R,A 
SP HL 
SP ‚IX 
Sp, IY 
SP,(x) 


‚c1Y+rx) 
L,BlL,cjt,djL,eju,H|L,L]L,CcHLy)L,A 
L,X 


SP,x|(x),A 


R 


(1X+x) 


R 
R 


ao YaYaY.%.Y 2.) 
xDIIOOOONIN 
SININININININZINTIS 
n = = = > = = = 

>zmpn > 


D 
I 


AF 
BC 
DE 
HL 
IX 
IY 


H AF 
H BC 
H DE 
H HL 
H IX 
H IY 


+X 


‚ce 
+x 


IX+x) 
1Y 
0 
X 


) 
|0.010,810,#]0,L10, cHL) |0,A 


Y+x) 
1,EI1,DITEMRITLIN.CHUD1,A 
K+xX 


Y+x) 
3 SDI SEI SSH BEE SCHE 3 
X+x 


Y+x) 
SD EISEHISSEISSERED A 
X+xX 


| 
I 
| 
12'c12 D|2,E|2,H|2,L|2,CHL)|2,A 
ae 
| 
l 
| 
IY+x) 
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CB_A8 


DD_CB_x1_B6 
FD_CB"x1_B6 
CB” BO 

DD”CB x1 BE 
FD_CB_x1_BE 


DD_CB_x1_16 
FD_CB_x1_16 
cB_10° 


17 


DD CB x1 06 
FD_CB_x1_06 


CB_00” 
07° 
ED_6F 


DD-CB_x1_1E 
FD_CB_x11E 
18 


DD CB x1 0E 
EO_cB"x110E 


FD_9YE_x1 


DD_CB_x1_C6 
FD_CB_x1_C6 


cB CO 


RES 
RES 
RES 
RES 
RES 
RES 
RES 
RET 
RET 
RET 
RET NC 

RET NZ 

RET P 

RET PE 

RET PO 

RET 2 

RETI 

RETN 

RL Ixex) 

RL 

RL ‚SICIDJEIMILICM.»]A 


RLC (IX+x) 

RLC (IY+x) 

RLC ale DENN IEHEDTA 
RLCA 


RLD 

RR (IX+x) 

RR (IY+x) 

RR eisen 


‚BIS, 5’ ‚D|5,E]5,H|5,L]5, HL) |5,A 
ix 

‚cIY+ 
‚56 a ‚D[6,E]6,H]6,L]6, CHL) |6,A 
ya 
‚B| 


7, e17, D|7,E|7,H|7,1|7, HL) |7,A 


EN NNNAOAOU 


RRC 
RRC 

RRC SICIDTEIHILICHLI]A 
RRCA 


RD 

RRA 

RST O 
RST OOH 
RST 08H 
RST OH 
RST 10H 
RST 16 
RST 18H 
RST 20H 
RST 24 


SBC A,CIX 

SBC A, (1Y+ 

SBC A ‚BA, 

SBC A,x 

SBC HL, BC 

SBC HL ‚DE 

SBC HL, HL 

SBC HL,SP 

SCF 

SET 0,(1X+x) 

SET 0,(IY+x) 

SET DER | 058 JO EDIOSEISEN]OLEIOSCHEITOEN 
(1X+x 


DD_CB_x1_CE SET 1 


FD_CB_x1_CE SET 


1,C1Y+x) 


CB_C8 
DD_CB_x1_D6 
FD_CB_x1_D6 


B 
DD_CB_x1_DE 
FD_CB_x1_DE 
CB_D8 
DD_CB_x1_E6 
FD_CB_xi_E6 
cB EO- 
DD_CB_x1_EE 
FD_CB_x1_EE 
CB_E8 
DD_CB_xi_F6 
FD_CB_x1_F6 
cB_FO 
DD_CB_x1_FE 


DD_CB_x1_26 
FD_CB_x1 26 
20 


CB 

DD’ CB x1 2E 
FD CB x1 _2E 
CB 28 
DD_CB_x1_3E 
FD_CB_x13E 
CB 38° 

DD 96 x1 
FD_96 x1 
90” 


D6_x1 
DD_AE_x1 
FD_AE_x1 
AB 

EE_x1 


SET 
SET 
SET 
SET 
SET 
SET 
SET 
SET 
SET 
SET 
SET 
SET 


SET 
SET 
SET 
SET 
SET 
SET 
SLA 
SLA 
SLA 
SRA 
SRA 
SRA 
SRL 
SRL 
SRL 
SUB 
SUB 
SUB 
SUB 


XOR 
XOR 
XOR 
XOR 


ber 
E 
I 
N 
N 
e 
N; 


ISO Dem Dome 09 mm DD mn 09 7 CD 


| 
u 
c| 


et. ‚DI1,E]1,H|1,L]1,cHL)|1,A 
c12, ‚D|2,.E|2,H]2,L|2,cHL)|2,A 
AP D|3,E]3,H]3,1|3, (HL) |3,A 
a ‚D]s,E|4,H|4,1L|4, (HL) |4,A 
ar ‚D|5,E|5,H|5,.15, (HL) |5,A 
ale ‚D|6,E]6,H]6,L|6,CHL)|6,A 


er, D|7,E|7,#]7,L|7,cHL) |7,A 


je 
je 
DIEIH|L|CHLY JA 
se] I IcHL>] 


Y+x) 
lA,CjA,DJA,EJA,H]A,L]A, HL) |A,A 
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Anhang E: Übersicht aller Editierbefehle von EDT 


Befehl Bedeutung 

[.+1) Leerbefehl (impliziter Druck) 
[.]a <Text> hinter Zeile anfügen 
<Text> 

(»2= € Zeilen ın <Text> ändern 
<Text> 

[44 Zeilen löschen 


e [Datei] benannte oder Standarddatei in den Puffer einlesen 
f [Datei] Standarddateinamen einstellen oder zeigen 
[.Ji <Text> vor Zeile einfügen 
<Text> 
[.,-.+1])j Zeilen zu einer Zeile zusammenfügen 
4 | aktuelle Zeilennummer anzeigen 
[-,-]  m# Zeilen verschieben, so daß sie Zeile # folgen 
[-,-]p[#] Zeilen drucken und Kontext auf # Zeilen setzen 
[.]r [Datei] 
Standard- oder benannte Dateı hinter Zeile in den Puffer 
lesen 
[-.,.]s/Muster/Ers./[g)rep 
das erste oder alle Muster ın den Zeilen ersetzen 
q editieren beenden 
V automatisches anzeigen ein- oder ausschalten 
[1,|]w [Datei] 
Zeilen in angegebene oder Standard-Datei schreiben 
| 12 Editierpuffer solange anzeigen, bis Taste gedrückt wird 


Befehlspräfixe 


[1, |]g/Muster/ 

globale Suche nach Zeilen mit Muster 
[1,|]x/Muster/ 

globale Suche nach Zeilen ohne Muster 
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Anhang F: Übersicht aller Formatierbefehle von FMT 


In der folgende Übersicht geben Zahlen in eckigen Klammern den Stan- 
dardwert für den jeweiligen Punktbefehl dar, der genommen wird, wenn 
keine andere Angabe gemacht wird. Parameter, die nicht in eckigen Klam- 
mern stehen, müssen angegeben werden; es existiert kein Standardwert. Ein 
Fragezeichen steht für ein einzelnes beliebiges Zeichen. Datei ist ein 
Dateiname, Text ist beliebiger Text. 


Befehl Bedeutung 

.bc ? Pseudo-Leerzeichen einstellen (blank character) 
.bf [1] fett (boldface) 

‚bp [(#+t1] Neue Seite beginnen (begin page) 

.br Neue Zeile beginnen (break) 

ce 2 Befehlszeichen einstellen (command character) 
.ce [1] zentrieren (center) 

.cu [1] durchgehend unterstreichen (continous underline) 
.Aw [1] doppelt breite Zeichen (double width) 

‚.ef [Text] Fußzeile für gerade Seiten (even-page footer) 
.eh [Text] Kopfzeile für gerade Seiten (even-page header) 


.fi Zeilen füllen (fill) 


.fo [Text] Fußzeile (footer) 

‚he [Text] Kopfzeile (header) 

.in [0] einrücken (indent) 

.it [1] kursiv (italicize) 

.Ju Blocksatz (justify) 

.lm [11] linker Rand (left margin) 

.1s [1] Zeilenabstand (line spacıng) 

.ml [1] Rand I (margin 1, oberer Rand zur Kopfzeile) 
.m2 [2] Rand 2 (margin 2, zwischen Text und m|) 

.m3 [2] Rand 3 (margin 3, zwischen Text und m4) 

.m4 [9] Rand 4 (margin 4, unterer Rand zur Fußzeile) 
.mc ? Feldbegrenzung ın der Datendatei (merge character) 
.mp [2] minimaler Platz für Absatz (minimum paragraph) 
.ne [0] Zeilen zusammenhalten (need) 

.nf nicht füllen (no filling) 

.N) kein Blocksatz (no justifying) 

.nu nicht unterstreichen (no underlining) 

.of [Text] Fußzeile für ungerade Seiten (odd-page footer) 
.oh [Text] Kopfzeile für ungerade Seiten (odd-page header) 
.pl [66] Seitenlänge (page lenght) 
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. PO 
.pr 
.rm 
.rS 
.SOo 
.Ssp 
.sq 
sel 
ul 


[0] 
'Text] 
[74] 
[0] 
Datei 
[1} 

[0} 

[0} 

[1] 


[Text] 


Seitenoffset (page offset) 
Eingabeaufforderung (prompt) 

rechter Rand (right margin) 

Platz reservieren (reserve space) 

Quelldatei für Text (source) 

Leerzeilen (space) 

zusammendrücken (squeeze) 

zeitweise einrücken (temporary indent) 

nicht durchgehend unterstreichen (underline) 
Kommentar 
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Register 


#asm, 22 
#endasm, 22 
#include, 27 


$, 55 


.., 139 

.?, 108 

‚bc, 129, 135 

.bf, 135 

.bp, 130, 135 
.br, 130, 135 

.cc, 135 

.ce, 130, 131, 135 
.cu, 132, 135 
.dw, 135 

.ef, 128, 136 

‚eh, 128, 136 

fi, 129, 130, 136 
‚fo, 128, 136 

‚he, 128, 136 

in, 130, 131, 136 
.it, 136 

.Jju, 130, 136 

Im, 128, 130, 137 
‚ls, 134, 137 

.ml, 128, 137 
‚m2, 128, 137 
‚m3, 128, 137 
.m4, 128, 137 
.mc, 137 

.mp, 134, 137 
.ne, 130, 134, 137 
.nf, 129, 130, 137 
.nj, 130, 138 
.nu, 138 

.of, 128, 138 

.oh, 128, 138 

.pl, 128, 138 

.po, 138 

.pr, 133, 138 
‚rm, 128, 138 

.rs, 138 

‚80, 133, 139 

.sp, 130, 134, 139 
.8q, 130, 131, 139 
‚Text, 132 

.ti, 130, 131, 139 
‚ul, 132, 139 


8080- Assembler, 7, 13 
8080-Assemblercode, 154 
8080-Mnemoniks, 58 
8080-Prozessor, 7, 13, 53 
8080.MIT, 89, 90, 176, 185 


abs, 51 

AR, 167, 175 
Archivdateien, 167, 175 
argc, 30 

Argumentzahl, 24, 174 
argv, 30 

Arithmetik, 26 

Arrays, 21 

ASCII-Datei, 34, 35 
Assembleranweisungen, 59 
Assemblercode, 22, 25, 29 
Assemblerlisting, 70 

atoi, 45 

atoib, 45 

Ausdrücke, 62 
Ausdrucksauswertung, 26, 27 
Ausgabedateiformat, 25 
auxbuf, 40 

avail, 31, 51 


BDOS, 30, 31, 81 
Bedienungshinweise, 68, 99, 
179 
Befehlskennzeichen, 126 
Befehlspräfixe, 195 
Befehlszeichen, 113, 135 
Befehlszeile, 98 
Befehlszeilenparameter, 67 
Benutzerschnittstelle, 67 
Bibliothek, 22, 29, 57, 75, 84, 
175 
Bibliotheksindex, 57 
Bibliotheksmodule, 176 
Bibliotheksverwalter, 84 
Bildschirm, 165 
BIOS-Erweiterung, 86 
Bitfelder, 21 
Blocksatz, 129, 136, 137, 138 


C-Compiler, 153 

C.LIB, 29, 78, 161, 175, 176 
CALL, 29, 30 

calloc, 51 

case, 27, 172 

Casts, 21 

CC.ARC, 167 

CC.DEF, 170, 171 

CC1.C, 170 

CC2.C, 170 


CC3.C, 170 

CC4.C, 170 

CCARGC, 24, 171, 174 

CCAVAILL, 171 

CCL, 166 

CCLEND, 166 

CCP, 30, 81, 98, 151, 177 

CCPCHAR, 173 

CCSXT, 174 

cfree, 31 

Change, 105 

CHG, 98, 105 

CLEAR, 164, 165 

clearerr, 39 

CLIB.ARC, 167, 175 

CLIB.DEF, 31 

CLIB.REL, 29, 175 

CMIT, 7, 53, 54, 55, 57, 89, 
176 

CNT, 107 

Codeoptimierung, 172 

COL, 171 

COM-Datei, 29, 53 

Compiler-Optionen, 171 

CON:, 33, 97 

Control-C, 69, 104, 105 

Control-N, 125 

Control-P, 104 

Control-Q, 104 

Control-S, 69, 105 

Control-X, 133 

Control-2Z, 34, 35, 97, 104, 110 

Copy, 108 

Count, 107 

CP/M, 8, 13, 31, 32, 34, 35, 52, 
53, 66, 81, 97, 153, 177 

CPT, 110, 153, 154 

CPY, 108, 112 

CRTHIGH, 165 

Crypt, 110, 153 

cseek, 33, 35, 40 

CSYSLIB, 29 

CSYSLIB.C, 30, 35 

ctell, 40 


Dateideskriptor, 31, 33 
Dateiformat, 97 
Dateisteuerblock, 32 
Dateiverwaltung, 31 
Dateninitialsierung, 22 
Datentypen, 22 

DB, 60, 62, 73 

DDT, 177, 178 
DEBUG, 79 

default, 172 
Deklaration, lokale, 23 
Detab, 111 
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DIN-Zeichensatz, 166 

DIR, 35 

Diskettenaufteilung, 153, 162 

Disketteninhalte, 8 

Diskettenkapazität, 8 

Diskettenverzeichnis, 9, 22, 35, 
96 

do, 172 

Dollarzeichen, 55, 65 

Doppeldruck, 135 

DREL, 7, 53, 54, 85, 93, 176 

Drucker, 165 

DS, 60, 93 

DTB, 11l 

dtoi, 45 

Dump, 93 

DW, 60, 62, 73 

DYNAMIC, 171 


Edit, 112 

Editierbefehle, 116, 195 

Editierpuffer, 112 

Editor, 112 

EDT, 112, 164, 195 

Ein-/Ausgabe, 22, 27, 34, 41 

Ein-/Ausgabe-Funktionen, 36 

Eingabe, 52 

Eingabe-Aufforderung, 133, 
138 

Einrücken, 126, 131, 136, 139 

Einsprungspunkt, 54, 71 

Einzelblattpapier, 127 

END, 61, 73, 78 

Endlospapier, 127 

ENDM, 62, 65 

Entab, 121 

entschlüsseln, 110 

EOF, 32, 33, 33, 36 

Epson-FX-80, 123 

Epson-Modus, 125, 132 

EQU, 61, 64 
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DIE PROGRAMM- 
BIBLIOTHEK FÜR 


TURBO PASCAL’ 


TURBO-Lader-Grundpaket 


Das TURBO-Lader-Grundmodul ist 
eine umfangreiche Programm-Biblio- 
thek für den TURBO-Pascal-Program- 
mierer. Sie umfaßt zahlreiche ausführ- 
lich dokumentierte Prozeduren und 
Funktionen, die der Profi zur schnellen 
Lösung seiner Programmieraufgaben 
verwenden kann. 


Das TURBO-Lader-Grundpaket er- 
tordert den TURBO-Pascal-Compi- 
ler. Es ist lieferbar auf 3”- und 
5 1/4 °-Disketten und lauffähig auf 
dem Schneider CPC 464, CPC 664, 
CPC 6128 und Joyce. 


3”-Disk. Best.-Nr. MS 413 
51,,"-Disk. Best.-Nr. MS 415 


DM 138,- 


TURBO-Lader Business 


TURBO-Lader Business umfaßt einen 
komfortablen Bildschirm-Maskenge- 
nerator und eine professionelle Datei- 
verwaltung. Der Maskengenerator 
gibt dem Pascal-Programmierer ein 
Werkzeug zur einfachen Bearbeitung 
von Bildschirm-Masken in die Hand. 


TURBO-Lader Business erfordert 
den TURBO-Pascal-Compiler und 
das TURBO-Lader-Grundpaket. Es 
ist lieferbar auf 3°- und 5 114" -Dis- 
ketten und lauffähig auf dem 
Schneider CPC 464, CPC 664, CPC 
6128 und Joyce. 


3”-Disk. Best.-Nr. MS 423 
51,,"-Disk. Best.-Nr. MS 425 


DM 148,* 


Markt&Technik 


Schneider CPC- 
Software 


ImtT 


Die Programm-Bibliothek für Turbo Pascal 


über 100 Prozeduren und Funktionen In 
Turbo Pascal Source Code: 
Bitmanipulation, Sortierverfahren, Spline- 
funktionen, Fouriertransformation, 
Regressionsanalyse und vieles mehr. 


3* Schneider-Format 





TURBO-Lader Science 


TURBO-Lader Science ist eine Samm- 
lung technisch/wissenschaftlicher 
Funktionen und professioneller stati- 
stischer Verfahren für die Bereiche 
Medizin, Betriebs- und Volkswirt- 
schaft, Technik und Naturwissen- 
schaften. 


TURBO-Lader Science erfordert den 
TURBO-Pascal-Compiler und das 
TURBO-Lader-Grundpaket. Es ist 
lieferbar auf 3”- und 5 1/4 ” -Disket- 
ten und lauffähig auf dem Schnel- 
der CPC 464, CPC 664, CPC 6128 
und Joyce. 


3”-Disk. Best.-Nr. MS 433 
5',,”-Disk. Best.-Nr. MS 435 


DM 189,- 


Übrigens können Sie auch folgende Turbo-Pascal-Produkte für Schneider CPC und Joyce bei Markt & Technik beziehen: 
Turbo Pascal 3.0, Turbo Pascal 3.0 mit Grafikunterstützung, 
Turbo Tutor (Deutsch), Turbo Tutor (Englisch), Turbo Graphik Toolbox, Turbo Toolbox. 
* inklusive MwSt., unverbindliche Preisempfehlung 


TURBO Pascal® ist ein Warenzeichen der Borland Inc., USA. TURBO-Lader, TURBO-Lader Business und 
TURBO-Lader Science sind Warenzeichen der Fa. Lauer & Waillnitz. 


Markt&fTechnik 


Schneider CPC 


Software 


Hans-Pinsel-Straße 2, 8013 Haar bei München 


Markt & achnik-Satwarspredakta erkalten Sie ia den Compwter-Abtellungen der Kaufkäuser und Im Computorshop. 














Schneider-Computer 


WordStar 3.0 mit MailMerge 


Der Bestseller unter den Textverarbeitungsprogrammen für PCs bie- 
tet Ihnen bildschirmorientierte Formatierung, deutschen Zeichen- 
satz und DIN-Tastatur sowie integrierte Hilfstexte. Mit MailMerge kön- 
nen Sie Serienbriefe mit persönlicher Anrede an eine beliebige 
Anzahl von Adressen schreiben und auch die AdreBaufkleber 
drucken. 


WordStar/MallMerge für den Schneider CPC 464°, CPC 664° 
Bestell-Nr. MS 101 (3° -Diskette) 

Bestell-Nr. MS 102 (5'4 °-Diskette Im VORTEX-Format) 
WordStar/MallMerge für den Schneider CPC 6128 

Bestell-Nr. MS 104 (3° -Diskette) 

WordStar/MailMerge für den Schneider Joyce PCW 8256 
Best.-Nr. MS 105 (3°-Diskette) 

Hardware-Anforderungen: Schneider CPC 464°, CPC 664°, CPC 
6128 oder Joyce, beliebiger Drucker mit Centronics-Schnittstelle 
* Der Standard-Speicherplatz beim CPC 464/664 erlaubt ohne 
Speichererweiterung Blockverschiebe-Operationen nur bedingt und 
Simultan-Drucken gar nicht. 


Dieses Programm kostet 
DM 199,- Inkl. MwSt. Unverbindliche Preisempfehlung 


Und dazu die 
weiterführende 
Literatur: 


Sie erhalten jedes WordStar-, dBASE Il- und MULTIPLAN-Pro- 
gramm für Ihren Schneider-Computer fertig angepaßt (Bildschirm- 
steuerung und Druckerinstallation). Jeweils Orliginalprodukte! 
Jedes Programmpaket enthält außerdem ein ausführliches Hand- 
buch mit kompakter Befehlsüberssich. Die VORTEX- 
Speichererweiterung für den Schneider CPC 464 erhalten Sie 
direkt bei der Firma VORTEX oder bei Ihrem Computerhändler. 


Diese Markt&Technik-Softwareprodukte erhalten Sie in den 
Computer-Abtellungen der Kaufhäuser oder bei Ihrem Com- 
puterhändler. 





Maraxischnik 
Schneider CPC 
Software 


WördStar 30 


mit MailMerge für den 
Schneider CPC 464/664 


3” Schneider-Format 





Mit diesem Buch haben Sie eine wertvolle Ergän- 
zung zum WordStar-Handbuch: Anhand vieler Bei- 
spiele steigen Sie mühelos in die Praxis der Textve- 
rarbeitungmit Wordstar ein. Angefangen beim ein- 
fachen Brief bis hin zur umfangreichen Manuskrip- 
terstellung zeigt Ihnen dieses Buch auch, wie Sie 
mit Hilfe von MailMerge Serienbriefe an eine belie- 
bige Anzahl von Adressen mit persönlicher Anrede 
senden können. 


„Nr. MT 
ISeN 3:580901 508 DM 49,- 


Erhältlich bel Ihrem Buchhändler. 


Markt&Technik 


Schneider CPC 
Software 


Hans-Pinsel-Straße 2, 8013 Haar bei München 











GE 


ANWENDER 


J. Hückstädt 


CP/M 2.2 Anwenderhandbuch 


CPC 464/664/6128 
Dezember 1985, 212 Seiten 


Wenn Sie glücklicher Besitzer eines Schneider- 
Computers sind und mehr wissen wollen über 
das leistungsstarke Betriebssystem CP/M 2.2, 
dann ist dieses Buch genau das richtige für Sie! 
Es behandelt CP/M 2.2 nicht nur in seiner allge- 
meinen Form, wie Sie für sämtliche CP/M- 
Computer gültig ist, sondern bezieht auch die 
Hardware der CPC-Computer mit ein. 


Best.-Nr. MT 859 
ISBN 3-89090-204-9 
DM 46,-IsFr. 42,3016S 358,80 


Markt & Technik-Fachbücher 
erhalten Sie bei Ihrem Buchhändler 
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Schneider CPC 
Grafik- 
Programmierung 


er ar 


ie 


BE ra Ei A Wine 


C. Straush 
Schneider EPC 


Grafik-Programmierung 
1. Quartal 1986, 225 Seiten 


Dieses Buch wendet sich an 
die Schneider CPC-Besitzer, 
die alles über die Grafikfähig- 
keiten ihres Computers wis- 
sen wollen. Es bietet einen 
umfassenden Überblick über 
die verschiedenen Anwen- 
dungsbereiche der Grafikpro- 
grammierung: zwei- und drei- 
dimensionale Diagrammdar- 
stellungen, Definition und 
Bewegung von Sprites, Ent- 
wurf von Titelgrafiken, Einsatz 
der Grafik bei der Unterstüt- 
zung anderer Programme. 

e Besonders interessant: ein 
Sprite-Generator, ein Malpro- 
gramm für hochauflösende 
Grafik, ein Programm zur 
Erstellung von Titelgrafiken 
sowie ein universelles Dar- 
stellungsprogramm. 

Best.-Nr. MT 90182 

ISBN 3-89090-182-4 

DM 46, -IsFr. 42,30/85 358,80 


Bucher zu 
Schneider CPCs 





J. Hückstädt 


Der Schneider CPC 6128 
September 1985, 273 Seiten 


Dieses Buch ist für jeden CPC 
6128-Besitzer eine wertvolle 
Hilfe, die vielfachen Möglich- 
keiten dieses bisher einmali- 
gen Computers kennenzuler- 
nen und anzuwenden. Der 
Computerneuling wird Schritt 
für Schritt in den Umgang mit 
dem Computer und die 
BASIC-Programmierung ein- 
geführt, bis er alle notwendi- 
gen Kenntnisse besitzt, die 
mancher Profi bereits mit- 
bringt. Aber an dieser Stelle 
wird das Programmieren mit 
dem CPC 6128 erst interes- 
sant, nämlich dann, wenn es 
darum geht, eine eigene 
Dateiverwaltung aufzubauen 
oder Grafik und Sound zu pro- 
grammieren. Weiterhin erlah- 
ren Sie alles über CP/M Plus 
auf dem CPC 6128. 

Best.-Nr. MT 849 

ISBN 3-89090-192-1 

DM 46. -/sFr. 42,3016S 358,80 
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Hans-Pinsel-Str. 2, 8013 Haar bei München 








Das Small-C-Entwicklungssystem 
ist ein komplettes Entwicklungs- 
paket für das Betriebssystem 
CP/M mit Editor, Compiler, 
Assembler, Linker und vielen 
weiteren Utilities. Alle Pro- 
gramme sind in Small-C ge- 
schrieben, und der Quellcode 
wird mitgeliefert! Dem kundigen 
Benutzer wird so die Möglichkeit 
gegeben, sich das Entwick- 
lungssystem nach seinen Wün- 
schen und Erfordernissen zu 
erweitern und zu modifizieren. 
Darüber hinaus erhält der 
Anwender damit eine umfangrei- 
che Sammlung praxisnaher Pro- 
gramme und Tools, die exzel- 
lente Beispiele für die effiziente 
Programmierung in © darstellen. 
Dadurch ist dieses Produkt eine 
wertvolle Fundgrube für jeden 
ernsthaften C-Programmiierer. 
Das Paket besteht aus drei Tei- 
len, die wiederum aus mehreren 
Komponenten bestehen. 


Markt &Technik 
Schneider CPC- 
Software 


Hans-Pinsel-Straße 2 
8013 Haar 


Small-C 


Enntwicklungssystem 


Small-C-Compiler 

Small-C ist ein umfangreicher 
Subset der Sprache C, dessen 
Qualität durch diese Programme 
selbst, die alle in dieser Sprache 
geschrieben wurden, dokumen- 
tiert wird. Der Compiler über- 
setzt C-Programme in 
8080-Assembler; zur Überset- 
zung des Assembler-Codes 
kann der mitgelieferte Makro- 
assembler, aber auch der 
Microsoft-Assembler verwendet 
werden. 


Small-MAC: 

Assembler und Utilities 

Der Makroassembler-Teil besteht 
aus sechs Programmen. MAC 
ist der eigentliche Makroassem- 
bler. Er arbeitet mit zwei Läufen 
und erzeugt relokatierbaren 
8-Bit-Objektcode im Microsoft- 
Format. MAC kann mit Hilfe des 
Programms CMIT an den Be- 
fehlssatz der Prozessoren 8080 
oder Z80 angepaßt werden. Der 
Linker LNK verknüpft Objekt- 
module mit den benötigten 
Bibliotheksmodulen zu ausführ- 
baren Programmen. Mit dem 
Loader LGO können Betriebs- 
systemerweiterungen geladen 
und gestartet werden. Der Bi- 
bliotheksmanager LIB verwaltet 





Bibliotheken mit LNK-kompati- 
blen Objektmodulen, und DREL 
erlaubt den Dump von LNK- und 
LIB-Dateien. 


Small-Tools: 

Editor und Text-Tools 
Small-Tools ist eine komfortable 
Sammlung von Text-Tools, die 
einen weiten Bereich der Text- 
verarbeitung abdecken, von der 
Eingabe von Programmen und 
Texten (EDIT) über die Erstel- 
lung von Serienbriefen und 
Formatierung von beliebigen 
Manuskripten (FORMAT) bis zur 
Rechtschreibüberprüfung (eng- 
lisch) und Sortierung von ASCII- 
Dateien (SORT/MERGE). Dar- 
über hinaus stehen noch etliche 
Hilfsprogramme zur Verfügung, 
die kleinere Aufgaben erledigen, 
jedoch kombiniert eingesetzt 
werden können und so zu einem 
extrem leistungsfähigen Tool 
werden. 


Hardware-Voraussetzungen 
Das Small-C-Entwicklungssystem 
benötigt einen Schneider-Com- 
puter mit mindestens 56 KByte 
Speicher und einem Disketten- 
laufwerk. Bei den Modellen 
CPC 464 und CPC 664 ist eine 
Speichererweiterung notwendig. 





